Developers
Bring the assistant to your app, your MCP client or your website. Every door costs the same as the chat app.
Start in 3 steps
- 1
Create your key
Get an API key under Profile → Developer. The key acts as your account.
Manage API keys → - 2
Try it here
In the playground below, pick an endpoint, paste your key and hit Test.
Playground → - 3
Add it to your code
Copy the ready cURL, JavaScript or Python snippet; see the tabs for MCP and the widget.
Documentation →
Playground
Pick an endpoint, fill in the parameters and hit Test. Requests are real; copy the code as-is.
POST/api/v1/conversations
Start a conversation: { text, locale?, model?, tools? } — use tools to create images, video, music or speech.
curl -X POST "https://yapayzeka.my/api/v1/conversations" \
-H "Authorization: Bearer sk_..." \
-H "Content-Type: application/json" \
-d '{"text":"…","locale":"en"}'Response body
The response will appear here.
Documentation
Multimedia
The chat app’s tools are in the API too: image, video, music, text-to-speech and web search. Add them with the tools field; generated files come back in the response’s media array with public URLs.
| Action | API name | Cost |
|---|---|---|
| Search the web | web_search | 1 credit |
| Create an image | generate_image | 3 credits |
| Create a video | generate_video | 10 credits / second |
| Create music | generate_music | 5 credits |
| Read text aloud | speak_text | 1 credit |
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" }
] }
]
}Images arrive with the answer. Video and music render in the background: read the conversation until generating is false. Tools that need an upload (image editing, audio analysis) aren’t in the API.