Ontwikkelaars

Breng de assistent naar je app, je MCP-client of je website. Overal kost het hetzelfde als in de chat.

Start in 3 stappen

1
Maak je sleutel
Haal een API-sleutel onder Profiel → Ontwikkelaar. De sleutel handelt als je account.
API-sleutels beheren →
2
Probeer het hier
Kies hieronder een endpoint, plak je sleutel en klik op Testen.
Speeltuin →
3
Voeg toe aan je code
Kopieer het kant-en-klare cURL-, JavaScript- of Python-voorbeeld; MCP en widget staan in de tabbladen.
Documentatie →

Speeltuin

Kies een endpoint, vul de parameters in en klik op Testen. Verzoeken zijn echt; kopieer de code zoals hij is.

POST/api/v1/conversations

Chat starten: { text, locale?, model?, tools? } — met tools maak je afbeeldingen, video, muziek of spraak.

HeadersAPI-sleutelInloggenAuthorization: BearerAlleen in het geheugen van deze pagina; nergens opgeslagen.

Bodytextmodel

tools

Laat leeg en de assistent beslist. Video en muziek worden op de achtergrond gemaakt; lees de chat voor het resultaat.

Wachten op antwoord

Echt verzoek: het bericht gaat van je credits af. (1 tegoed)

Code

curl -X POST "https://yapayzeka.my/api/v1/conversations" \
  -H "Authorization: Bearer sk_..." \
  -H "Content-Type: application/json" \
  -d '{"text":"…","locale":"nl"}'

Antwoordbody

Het antwoord verschijnt hier.

Documentatie

Authenticatie

Maak een API-sleutel aan onder Profiel → Ontwikkelaar en stuur hem als header mee met elk verzoek. De sleutel handelt als je account; deel hem niet.

Authorization: Bearer sk_...

REST API

JSON erin, JSON eruit. Antwoorden worden op de achtergrond geschreven: stuur een bericht en lees de chat tot `pending` false is.

POST/api/v1/conversationsChat starten: { text, locale?, model?, tools? } — met tools maak je afbeeldingen, video, muziek of spraak.
POST/api/v1/conversations/{id}Bericht toevoegen: { text, locale?, model?, tools? }
GET/api/v1/conversations/{id}Laatste berichten en `pending`-status
GET/api/v1/conversationsJe recente chats
GET/api/v1/creditsJe resterende credits
GET/api/v1/toolsBeschikbare tools en kosten

curl -X POST https://yapayzeka.my/api/v1/conversations \
  -H "Authorization: Bearer sk_..." \
  -H "Content-Type: application/json" \
  -d '{"text": "Merhaba", "locale": "nl", "thinking": false}'
# → {"id": "…"}  — lees het antwoord een paar seconden later
curl https://yapayzeka.my/api/v1/conversations/{id} -H "Authorization: Bearer sk_..."

Optionele velden: thinking (false → redeneren uit, snellere en goedkopere antwoorden), instructions (systeeminstructies voor deze beurt, tot 20.000 tekens; stuur ze bij elk verzoek mee), private (true → 402 needs-private als je abonnement geen privéchats toestaat). Gelezen berichten bevatten het redeneren van het model in het veld reasoning.

Fouten: 401 ongeldige sleutel · 402 te weinig credits of Pro vereist · 409 vorig antwoord bezig of toestemming vereist · 429 limiet.