Sviluppatori
Porta l’assistente nella tua app, nel tuo client MCP o sul tuo sito. Ovunque costa come nella chat.
Inizia in 3 passi
- 1
Crea la tua chiave
Ottieni una chiave API in Profilo → Sviluppatore. La chiave agisce come il tuo account.
Gestisci chiavi API → - 2
Provalo qui
Nell’area di prova scegli un endpoint, incolla la chiave e premi Prova.
Area di prova → - 3
Aggiungilo al codice
Copia l’esempio pronto in cURL, JavaScript o Python; MCP e widget sono nelle schede.
Documentazione →
Area di prova
Scegli un endpoint, compila i parametri e premi Prova. Le richieste sono reali; copia il codice così com’è.
POST/api/v1/conversations
Avvia una chat: { text, locale?, model?, tools? } — con tools crea immagini, video, musica o voce.
curl -X POST "https://yapayzeka.my/api/v1/conversations" \
-H "Authorization: Bearer sk_..." \
-H "Content-Type: application/json" \
-d '{"text":"…","locale":"it"}'Corpo della risposta
La risposta apparirà qui.
Documentazione
Autenticazione
Crea una chiave API in Profilo → Sviluppatore e inviala come intestazione a ogni richiesta. La chiave agisce come il tuo account; non condividerla.
Authorization: Bearer sk_...API REST
JSON in entrata e in uscita. Le risposte si scrivono in background: invia il messaggio, poi leggi la chat finché `pending` è false.
POST/api/v1/conversationsAvvia una chat: { text, locale?, model?, tools? } — con tools crea immagini, video, musica o voce.POST/api/v1/conversations/{id}Aggiungi un messaggio: { text, locale?, model?, tools? }GET/api/v1/conversations/{id}Ultimi messaggi e stato `pending`GET/api/v1/conversationsLe tue chat recentiGET/api/v1/creditsI tuoi crediti rimanentiGET/api/v1/toolsStrumenti disponibili e costi
curl -X POST https://yapayzeka.my/api/v1/conversations \
-H "Authorization: Bearer sk_..." \
-H "Content-Type: application/json" \
-d '{"text": "Merhaba", "locale": "it", "thinking": false}'
# → {"id": "…"} — leggi la risposta qualche secondo dopo
curl https://yapayzeka.my/api/v1/conversations/{id} -H "Authorization: Bearer sk_..."Campi facoltativi: thinking (false → ragionamento disattivato, risposte più rapide ed economiche), instructions (istruzioni di sistema per questo turno, fino a 20.000 caratteri; inviale a ogni richiesta), private (true → 402 needs-private se il tuo piano non consente chat private). I messaggi letti riportano il ragionamento del modello nel campo reasoning.
Errori: 401 chiave non valida · 402 crediti insufficienti o serve Pro · 409 risposta precedente in corso o serve il consenso · 429 limite di frequenza.