Desarrolladores
Lleva el asistente a tu app, a tu cliente MCP o a tu web. En todas partes cuesta lo mismo que en el chat.
Empieza en 3 pasos
- 1
Crea tu clave
Consigue una clave API en Perfil → Desarrollador. La clave actúa como tu cuenta.
Gestionar claves API → - 2
Pruébalo aquí
En la zona de pruebas elige un endpoint, pega tu clave y pulsa Probar.
Zona de pruebas → - 3
Añádelo a tu código
Copia el ejemplo listo en cURL, JavaScript o Python; MCP y widget están en las pestañas.
Documentación →
Zona de pruebas
Elige un endpoint, rellena los parámetros y pulsa Probar. Las peticiones son reales; copia el código tal cual.
POST/api/v1/conversations
Iniciar conversación: { text, locale?, model?, tools? } — con tools genera imágenes, vídeo, música o voz.
curl -X POST "https://yapayzeka.my/api/v1/conversations" \
-H "Authorization: Bearer sk_..." \
-H "Content-Type: application/json" \
-d '{"text":"…","locale":"es"}'Cuerpo de la respuesta
La respuesta aparecerá aquí.
Documentación
Autenticación
Crea una clave API en Perfil → Desarrollador y envíala como cabecera en cada petición. La clave actúa como tu cuenta; no la compartas.
Authorization: Bearer sk_...API REST
JSON de entrada y salida. Las respuestas se escriben en segundo plano: envía el mensaje y lee la conversación hasta que `pending` sea false.
POST/api/v1/conversationsIniciar conversación: { text, locale?, model?, tools? } — con tools genera imágenes, vídeo, música o voz.POST/api/v1/conversations/{id}Añadir mensaje: { text, locale?, model?, tools? }GET/api/v1/conversations/{id}Últimos mensajes y estado `pending`GET/api/v1/conversationsTus conversaciones recientesGET/api/v1/creditsTus créditos restantesGET/api/v1/toolsHerramientas disponibles y su coste
curl -X POST https://yapayzeka.my/api/v1/conversations \
-H "Authorization: Bearer sk_..." \
-H "Content-Type: application/json" \
-d '{"text": "Merhaba", "locale": "es", "thinking": false}'
# → {"id": "…"} — lee la respuesta unos segundos después
curl https://yapayzeka.my/api/v1/conversations/{id} -H "Authorization: Bearer sk_..."Campos opcionales: thinking (false → razonamiento desactivado, respuestas más rápidas y baratas), instructions (instrucciones de sistema para este turno, hasta 20.000 caracteres; envíalas en cada solicitud), private (true → 402 needs-private si tu plan no permite chats privados). Los mensajes leídos incluyen el razonamiento del modelo en el campo reasoning.
Errores: 401 clave no válida · 402 créditos insuficientes o requiere Pro · 409 respuesta anterior en curso o falta consentimiento · 429 límite de ritmo.