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);

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": "سلام"}
    ]
  }'

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"
  }
}