Développeurs

Intégrez l’assistant à votre app, à votre client MCP ou à votre site. Partout, le coût est le même que dans le chat.

Démarrer en 3 étapes

1
Créez votre clé
Obtenez une clé API dans Profil → Développeur. La clé agit en votre nom.
Gérer les clés API →
2
Essayez ici
Dans le bac à sable ci-dessous, choisissez un endpoint, collez votre clé et cliquez sur Tester.
Bac à sable →
3
Intégrez-le
Copiez l’exemple prêt en cURL, JavaScript ou Python ; MCP et widget sont dans les onglets.
Documentation →

Bac à sable

Choisissez un endpoint, remplissez les paramètres et cliquez sur Tester. Les requêtes sont réelles ; copiez le code tel quel.

POST/api/v1/conversations

Démarrer une discussion : { text, locale?, model?, tools? } — avec tools, créez images, vidéo, musique ou voix.

En-têtesClé APISe connecterAuthorization: BearerConservée uniquement dans la mémoire de cette page ; jamais enregistrée.

Corpstextmodel

tools

Laissez vide pour laisser l’assistant décider. Vidéo et musique sont générées en arrière-plan ; relisez la discussion.

Attendre la réponse

Requête réelle : le message est débité de vos crédits. (1 crédit)

Code

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

Corps de la réponse

La réponse s’affichera ici.

Documentation

Authentification

Créez une clé API dans Profil → Développeur et envoyez-la en en-tête à chaque requête. La clé agit en votre nom ; ne la partagez pas.

Authorization: Bearer sk_...

API REST

JSON en entrée et en sortie. Les réponses s’écrivent en arrière-plan : envoyez le message, puis lisez la discussion jusqu’à `pending` false.

POST/api/v1/conversationsDémarrer une discussion : { text, locale?, model?, tools? } — avec tools, créez images, vidéo, musique ou voix.
POST/api/v1/conversations/{id}Ajouter un message : { text, locale?, model?, tools? }
GET/api/v1/conversations/{id}Derniers messages et état `pending`
GET/api/v1/conversationsVos discussions récentes
GET/api/v1/creditsVos crédits restants
GET/api/v1/toolsOutils disponibles et coût en crédits

curl -X POST https://yapayzeka.my/api/v1/conversations \
  -H "Authorization: Bearer sk_..." \
  -H "Content-Type: application/json" \
  -d '{"text": "Merhaba", "locale": "fr", "thinking": false}'
# → {"id": "…"}  — lisez la réponse quelques secondes plus tard
curl https://yapayzeka.my/api/v1/conversations/{id} -H "Authorization: Bearer sk_..."

Champs facultatifs : thinking (false → raisonnement désactivé, réponses plus rapides et moins chères), instructions (instructions système pour ce tour, jusqu’à 20 000 caractères ; à renvoyer à chaque requête), private (true → 402 needs-private si ton offre n’autorise pas les discussions privées). Les messages lus contiennent le raisonnement du modèle dans le champ reasoning.

Erreurs : 401 clé invalide · 402 crédits insuffisants ou Pro requis · 409 réponse précédente en cours ou consentement requis · 429 limite de débit.