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.

HeadersAPI keySign inAuthorization: BearerKept only in this page’s memory; never stored anywhere.

Bodytextmodel

tools

Leave empty to let the assistant decide. Video and music render in the background; read the conversation for the result.

Wait for the answer

Real request: the message cost is charged to your credits. (1 credit)

Code

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

Authentication

Create an API key under Profile → Developer and send it as a header with every request. The key acts as your account; never share it.

Authorization: Bearer sk_...

REST API

JSON in, JSON out. Answers are written in the background: send a message, then read the conversation until `pending` is false.

POST/api/v1/conversationsStart a conversation: { text, locale?, model?, tools? } — use tools to create images, video, music or speech.
POST/api/v1/conversations/{id}Add a message: { text, locale?, model?, tools? }
GET/api/v1/conversations/{id}Latest messages and the `pending` state
GET/api/v1/conversationsYour recent conversations
GET/api/v1/creditsYour remaining credits
GET/api/v1/toolsAvailable tools and their credit costs

curl -X POST https://yapayzeka.my/api/v1/conversations \
  -H "Authorization: Bearer sk_..." \
  -H "Content-Type: application/json" \
  -d '{"text": "Merhaba", "locale": "en", "thinking": false}'
# → {"id": "…"}  — read the answer a few seconds later
curl https://yapayzeka.my/api/v1/conversations/{id} -H "Authorization: Bearer sk_..."

Optional fields: thinking (false → reasoning off, faster and cheaper answers), instructions (system instructions for this turn, up to 20,000 characters; send them with every request), private (true → 402 needs-private if your plan doesn’t allow private chats). Messages you read carry the model’s reasoning in the reasoning field.

Errors: 401 invalid key · 402 not enough credits or Pro required · 409 previous answer in progress or consent required · 429 rate limit.