API Kaya AI

Authorization: Bearer sk-llm-your-api-key
# یا برای Anthropic Messages / Claude Code:
x-api-key: sk-llm-your-api-key

{
  "id": "gen-...",
  "object": "chat.completion",
  "model": "deepseek/deepseek-v4-flash",
  "choices": [{
    "index": 0,
    "message": {
      "role": "assistant",
      "content": "سلام! من خوبم، ممنون که پرسیدی."
    },
    "finish_reason": "stop"
  }],
  "usage": {
    "prompt_tokens": 12,
    "completion_tokens": 18,
    "total_tokens": 30
  }
}

GET https://kayaai.ir/api/embeddings
POST https://kayaai.ir/api/embeddings

curl -X POST https://kayaai.ir/api/embeddings \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-llm-your-api-key" \
  -d '{
    "model": "openai/text-embedding-3-small",
    "input": "The quick brown fox jumps over the lazy dog"
  }'

const response = await fetch('https://kayaai.ir/api/embeddings', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'Authorization': 'Bearer sk-llm-your-api-key',
  },
  body: JSON.stringify({
    model: 'openai/text-embedding-3-small',
    input: 'The quick brown fox jumps over the lazy dog',
  }),
});
const data = await response.json();
console.log(data.data[0].embedding.length);

GET https://kayaai.ir/api/images/generations
POST https://kayaai.ir/api/images/generations

curl -X POST https://kayaai.ir/api/images/generations \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-llm-your-api-key" \
  -d '{
    "model": "openai/gpt-image-1",
    "prompt": "a red panda astronaut floating in space",
    "aspect_ratio": "1:1"
  }'

const response = await fetch('https://kayaai.ir/api/images/generations', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'Authorization': 'Bearer sk-llm-your-api-key',
  },
  body: JSON.stringify({
    model: 'openai/gpt-image-1',
    prompt: 'a red panda astronaut floating in space',
    aspect_ratio: '1:1',
  }),
});
const data = await response.json();

GET https://kayaai.ir/api/audio/speech
POST https://kayaai.ir/api/audio/speech

curl -X POST https://kayaai.ir/api/audio/speech \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-llm-your-api-key" \
  --output output.mp3 \
  -d '{
    "model": "openai/gpt-4o-mini-tts-2025-12-15",
    "input": "Hello! This is a text-to-speech test.",
    "voice": "alloy",
    "response_format": "mp3"
  }'

const response = await fetch('https://kayaai.ir/api/audio/speech', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'Authorization': 'Bearer sk-llm-your-api-key',
  },
  body: JSON.stringify({
    model: 'openai/gpt-4o-mini-tts-2025-12-15',
    input: 'Hello! This is a text-to-speech test.',
    voice: 'alloy',
    response_format: 'mp3',
  }),
});
const blob = await response.blob();

GET https://kayaai.ir/api/audio/transcriptions
POST https://kayaai.ir/api/audio/transcriptions

curl -X POST https://kayaai.ir/api/audio/transcriptions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-llm-your-api-key" \
  -d '{
    "model": "openai/whisper-1",
    "input_audio": {
      "data": "<base64-encoded-audio>",
      "format": "wav"
    }
  }'

const response = await fetch('https://kayaai.ir/api/audio/transcriptions', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'Authorization': 'Bearer sk-llm-your-api-key',
  },
  body: JSON.stringify({
    model: 'openai/whisper-1',
    input_audio: { data: base64Audio, format: 'wav' },
  }),
});
const data = await response.json();
console.log(data.text);

GET https://kayaai.ir/api/decisions
POST https://kayaai.ir/api/decisions

curl -X POST https://kayaai.ir/api/decisions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-llm-your-api-key" \
  -d '{
    "model": "typesafe/jev-1.13",
    "state": {
      "ticket": "My checkout page shows a blank screen after I click Pay."
    },
    "questions": {
      "is_bug": {
        "type": "noul",
        "instructions": "Is the customer reporting a software defect?",
        "criteria": {
          "true": "The customer describes broken or unexpected product behavior.",
          "false": "The customer is asking a question or requesting a feature."
        }
      },
      "team": {
        "type": "choice",
        "instructions": "Which team should own this ticket?",
        "criteria": {
          "frontend": "Rendering, layout, or browser compatibility issues.",
          "payments": "Checkout, billing, or payment processing issues."
        }
      }
    }
  }'

const response = await fetch('https://kayaai.ir/api/decisions', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'Authorization': 'Bearer sk-llm-your-api-key',
  },
  body: JSON.stringify({
    model: 'typesafe/jev-1.13',
    state: { ticket: 'My checkout page shows a blank screen after I click Pay.' },
    questions: {
      is_bug: {
        type: 'noul',
        instructions: 'Is the customer reporting a software defect?',
        criteria: {
          true: 'The customer describes broken or unexpected product behavior.',
          false: 'The customer is asking a question or requesting a feature.',
        },
      },
      team: {
        type: 'choice',
        instructions: 'Which team should own this ticket?',
        criteria: {
          frontend: 'Rendering, layout, or browser compatibility issues.',
          payments: 'Checkout, billing, or payment processing issues.',
        },
      },
    },
  }),
});
const data = await response.json();
console.log(data.answers);

https://kayaai.ir/api

# ~/.bashrc or ~/.zshrc
export ANTHROPIC_BASE_URL="https://kayaai.ir/api"
export ANTHROPIC_AUTH_TOKEN="sk-llm-your-api-key"
export ANTHROPIC_API_KEY=""

# Optional: choose a model from the catalog (Gemini, Ling, Claude, ...)
# export ANTHROPIC_DEFAULT_SONNET_MODEL="google/gemini-2.5-flash"
# export ANTHROPIC_DEFAULT_OPUS_MODEL="anthropic/claude-opus-4"
# export ANTHROPIC_DEFAULT_HAIKU_MODEL="deepseek/deepseek-v4-flash"

curl -X POST https://kayaai.ir/api/v1/messages \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-llm-your-api-key" \
  -H "anthropic-version: 2023-06-01" \
  -d '{
    "model": "anthropic/claude-sonnet-4",
    "max_tokens": 256,
    "messages": [
      {"role": "user", "content": "سلام"}
    ]
  }'

# ~/.bashrc or ~/.zshrc
export OPENAI_BASE_URL="https://kayaai.ir/api/v1"
export OPENAI_API_KEY="sk-llm-your-api-key"

# Codex uses the Responses API by default when OPENAI_BASE_URL is set.
# OPTIONAL: force the wire protocol in case you point at a plain chat URL:
# export OPENAI_WIRE_API="responses"

# Optional: pick a model from the catalog (defaults to a capable chat model)
# export OPENAI_MODEL="deepseek/deepseek-v4-flash"

curl -X POST https://kayaai.ir/api/v1/responses \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-llm-your-api-key" \
  -d '{
    "model": "deepseek/deepseek-v4-flash",
    "input": "سلام! فقط بنویس: تست موفق",
    "max_output_tokens": 256
  }'

curl -X POST https://kayaai.ir/api/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-llm-your-api-key" \
  -d '{
    "model": "deepseek/deepseek-v4-flash",
    "messages": [
      {"role": "user", "content": "سلام، چطوری؟"}
    ],
    "stream": true
  }'

data: [DONE]

const response = await fetch('https://kayaai.ir/api/chat/completions', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'Authorization': 'Bearer sk-llm-your-api-key',
  },
  body: JSON.stringify({
    model: 'deepseek/deepseek-v4-flash',
    messages: [{ role: 'user', content: 'یک داستان کوتاه بنویس' }],
    stream: true,
  }),
});

const reader = response.body.getReader();
const decoder = new TextDecoder();
let buffer = '';

while (true) {
  const { done, value } = await reader.read();
  if (done) break;
  buffer += decoder.decode(value, { stream: true });
  const lines = buffer.split('\n');
  buffer = lines.pop() || '';
  for (const line of lines) {
    if (!line.startsWith('data: ')) continue;
    const payload = line.slice(6).trim();
    if (payload === '[DONE]') break;
    const chunk = JSON.parse(payload);
    const delta = chunk.choices?.[0]?.delta?.content;
    if (delta) process.stdout.write(delta);
  }
}

deepseek/deepseek-v4-flash
openai/gpt-4o-mini
google/gemini-2.5-flash
minimax/minimax-m2.5

{
  "error": {
    "message": "توضیح خطا به فارسی",
    "type": "invalid_request_error"
  }
}

https://kayaai.ir/api/account

curl -s https://kayaai.ir/api/account \
  -H "Authorization: Bearer sk-llm-your-api-key"

{
  "account": {
    "id": "cm...",
    "name": "نام شما",
    "email": null,
    "phone": "0912...",
    "phoneVerified": true,
    "createdAt": "2026-01-01T00:00:00.000Z"
  },
  "credits": { "balance": 1200.5, "totalUsed": 42.25, "totalPurchased": 1500 },
  "key": {
    "id": "cm...",
    "name": "کلید تولیدی",
    "maskedKey": "sk-llm-1a2b...9f0e",
    "isActive": true,
    "isExpired": false,
    "canManageKeys": false,
    "expiresAt": null,
    "creditLimit": null,
    "limitUsed": 0,
    "creditLimitRemaining": null
  }
}

const res = await fetch('https://kayaai.ir/api/account', {
  headers: { Authorization: 'Bearer sk-llm-your-api-key' },
});
const { account, credits, key } = await res.json();

console.log(account.name, account.phone);
console.log('موجودی:', credits.balance);

curl -s "https://kayaai.ir/api/account/usage?model=deepseek/deepseek-v4-flash&limit=50&offset=0" \
  -H "Authorization: Bearer sk-llm-your-api-key"

{
  "filters": { "model": "deepseek/deepseek-v4-flash", "from": null, "to": null },
  "summary": {
    "totalRequests": 128,
    "successfulRequests": 126,
    "failedRequests": 2,
    "successRate": 98.44,
    "totalInputTokens": 152340,
    "totalOutputTokens": 98400,
    "totalCredits": 87.31,
    "byModel": [
      { "model": "deepseek/deepseek-v4-flash", "provider": "deepseek",
        "requests": 128, "inputTokens": 152340, "outputTokens": 98400, "credits": 87.31 }
    ]
  },
  "history": {
    "items": [
      { "id": "cm...", "model": "deepseek/deepseek-v4-flash", "provider": "deepseek",
        "requestType": "chat", "inputTokens": 540, "outputTokens": 320,
        "credits": 0.31, "status": "success", "createdAt": "2026-10-16T09:30:00.000Z" }
    ],
    "total": 128, "limit": 50, "offset": 0, "hasMore": true
  }
}

const res = await fetch(
  'https://kayaai.ir/api/account/usage?limit=20',
  { headers: { Authorization: 'Bearer sk-llm-your-api-key' } },
);
const { summary, history } = await res.json();

console.log(summary.totalRequests, summary.totalCredits);
summary.byModel.forEach((m) =>
  console.log(m.model, m.requests, m.credits)
);

curl -X PATCH https://kayaai.ir/api/account/keys/KEY_ID \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-llm-your-manager-key" \
  -d '{
    "creditLimit": 500,
    "expiresAt": "2027-01-01T00:00:00.000Z",
    "isActive": true
  }'

curl -s https://kayaai.ir/api/account/keys \
  -H "Authorization: Bearer sk-llm-your-manager-key"

curl -X POST https://kayaai.ir/api/account/keys/KEY_ID/reset-quota \
  -H "Authorization: Bearer sk-llm-your-manager-key"