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
Multimedia
Gli strumenti della chat sono anche nell’API: immagini, video, musica, sintesi vocale e ricerca web. Aggiungili con il campo tools; i file generati tornano nell’array media con URL pubblico.
| Azione | Nome API | Costo |
|---|---|---|
| Cerca sul web | web_search | 1 credito |
| Crea un’immagine | generate_image | 3 crediti |
| Crea un video | generate_video | 10 crediti / secondo |
| Crea musica | generate_music | 5 crediti |
| Leggi il testo ad alta voce | speak_text | 1 credito |
curl -X POST https://yapayzeka.my/api/v1/conversations \
-H "Authorization: Bearer sk_..." \
-H "Content-Type: application/json" \
-d '{"text": "a red fox in the snow, watercolor", "tools": ["generate_image"]}'
# GET /api/v1/conversations/{id}
{
"pending": false,
"generating": false,
"messages": [
{ "role": "assistant", "content": "…", "media": [
{ "name": "image.png", "type": "image/png", "url": "https://…/image.png" }
] }
]
}Le immagini arrivano con la risposta. Video e musica si generano in background: leggi la chat finché generating è false. Gli strumenti che richiedono un caricamento non sono nell’API.