Мазмұнға өту

API құжаттамасы

AI Router OpenAI API форматымен толық үйлесімді. Кез келген SDK немесе HTTP-клиентті қолданыңыз — тек base_url мен API кілтін өзгертіңіз.

Жылдам бастау

AI Router-ді 2 минуттан аз уақытта іске қосыңыз. Егер сіз OpenAI SDK қолдансаңыз — тек екі параметрді өзгертсеңіз жеткілікті.

Python
from openai import OpenAI

client = OpenAI(
    base_url="https://api.airouter.kz/api/v1",
    api_key="air_live_your_key_here"
)

response = client.chat.completions.create(
    model="openai/gpt-5.4",
    messages=[
        {"role": "user", "content": "Summarize the OpenAI Chat Completions schema in one sentence."}
    ]
)

print(response.choices[0].message.content)
JavaScript / TypeScript
import OpenAI from "openai";

const client = new OpenAI({
    baseURL: "https://api.airouter.kz/api/v1",
    apiKey: "air_live_your_key_here"
});

const response = await client.chat.completions.create({
    model: "anthropic/claude-opus-4-7",
    messages: [
        { role: "user", content: "Summarize the OpenAI Chat Completions schema in one sentence." }
    ]
});

console.log(response.choices[0].message.content);
cURL
curl https://api.airouter.kz/api/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer air_live_your_key_here" \
  -d '{
    "model": "google/gemini-3-pro",
    "messages": [
      {"role": "user", "content": "Summarize the OpenAI Chat Completions schema in one sentence."}
    ]
  }'

Аутентификация

Барлық API-сұраныстар Authorization тақырыбында Bearer-токен ретінде API-кілтті талап етеді.

API-кілт форматы

AI Router API-кілттерінде air_live_ префиксі және 43 base64url таңбасы бар. Мысал:

air_live_abc123def456ghi789jkl012mno345pqr678stu

Тақырып форматы

Authorization: Bearer air_live_your_key_here

Кілттерді жасау және басқару — панельде немесе API-кілттерді басқару эндпоинттері арқылы.

Негізгі URL

$https://api.airouter.kz/api/v1

Барлық эндпоинттер осы негізгі URL-ге қатысты. API OpenRouter және OpenAI жолдарымен толық үйлесімді.

SDK және кітапханалар

AI Router кастомды base URL-ді қолдайтын кез келген SDK-мен жұмыс істейді. Арнайы SDK қажет емес.

OpenAI Python SDK

pip install openai

base_url-ді https://api.airouter.kz/api/v1 ретінде қойыңыз

OpenAI Node.js SDK

npm install openai

baseURL-ді https://api.airouter.kz/api/v1 ретінде қойыңыз

LangChain

pip install langchain-openai

ChatOpenAI-ді openai_api_base параметрімен пайдаланыңыз

LlamaIndex

pip install llama-index-llms-openai

OpenAI LLM класында api_base қойыңыз

Эндпоинттер

AI Router OpenRouter және OpenAI-мен бірдей эндпоинт жолдарын іске асырады. Сұраныс пен жауап схемалары бірдей.

ӘдісЖолСипаттама
POST/api/v1/chat/completionsЧат-комплишен жасау
POST/api/v1/images/generationsСурет генерациялау
POST/api/v1/audio/speechСөз синтезі
POST/api/v1/audio/transcriptionsСөзді тану
GET/api/v1/modelsҚолжетімді модельдер тізімі
GET/api/v1/generation?id=Генерация мәліметтері
GET/api/v1/creditsБалансты тексеру
GET/api/v1/keysAPI-кілттер тізімі
POST/api/v1/keysЖаңа API-кілт жасау
PATCH/api/v1/keys/:idAPI-кілтті жаңарту
DELETE/api/v1/keys/:idAPI-кілтті өшіру

POST /api/v1/chat/completions

Чат-комплишен жасаңыз. AI Router арқылы кез келген AI-моделімен өзара әрекеттесудің негізгі эндпоинті. Сұраныс пен жауап форматы OpenAI Chat Completions API-мен бірдей.

Сұраныс денесі
{
  "model": "openai/gpt-5.4",
  "messages": [
    {
      "role": "system",
      "content": "You are a helpful assistant."
    },
    {
      "role": "user",
      "content": "Explain quantum computing in simple terms."
    }
  ],
  "temperature": 0.7,
  "max_tokens": 1000,
  "stream": false
}
Жауап
{
  "id": "gen-abc123",
  "object": "chat.completion",
  "created": 1713200000,
  "model": "openai/gpt-5.4",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "Quantum computing uses quantum mechanics..."
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 25,
    "completion_tokens": 150,
    "total_tokens": 175
  }
}

Модель ID форматы

Модель ID provider/model-name форматында. Мысалдар:

  • openai/gpt-5.4
  • anthropic/claude-opus-4-7
  • google/gemini-3-pro
  • deepseek/deepseek-v3.2
  • mistral/mistral-large-3
  • xai/grok-4

Стриминг

Server-Sent Events (SSE) алу үшін "stream": true қойыңыз. Жауап форматы OpenAI streaming спецификациясымен сәйкес, data: [DONE] соңғы оқиға ретінде.

POST /api/v1/images/generations

GPT-Image-1, Imagen 4, FLUX 1.1 Pro және басқа frontier-модельдерімен сурет генерациясы. Сұраныс форматы OpenAI Images API-мен сәйкес.

cURL
curl https://api.airouter.kz/api/v1/images/generations \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer air_live_your_key_here" \
  -d '{
    "model": "openai/gpt-image-1",
    "prompt": "a white siamese cat",
    "n": 1,
    "size": "1024x1024"
  }'
Жауап
{
  "created": 1713200000,
  "data": [
    {
      "url": "https://...",
      "revised_prompt": "A white Siamese cat with blue eyes..."
    }
  ]
}

Қолдау көрсетілетін өлшемдер

  • 1024x1024
  • 1792x1024
  • 1024x1792

POST /api/v1/audio/speech

Мәтінді табиғи дауыстық сөйлеуге түрлендіру. Әдепкі бойынша Content-Type: audio/mpeg арқылы шикі аудио-байттарды қайтарады.

cURL
curl https://api.airouter.kz/api/v1/audio/speech \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer air_live_your_key_here" \
  -d '{
    "model": "openai/gpt-4o-mini-tts",
    "input": "Hello, welcome to AI Router!",
    "voice": "alloy"
  }' \
  --output speech.mp3

Қолжетімді дауыстар

alloyechofableonyxnovashimmer

Жауап форматы

Жауап — шикі аудио-байттар (JSON емес). Әдепкі content type — audio/mpeg. response_format арқылы opus, aac немесе flac форматтарын сұрауға болады.

POST /api/v1/audio/transcriptions

GPT-4o Transcribe және басқа модельдерімен аудио-файлдарды мәтінге транскрипциялау. multipart/form-data сұраныстарын қабылдайды.

cURL
curl https://api.airouter.kz/api/v1/audio/transcriptions \
  -H "Authorization: Bearer air_live_your_key_here" \
  -F file="@audio.mp3" \
  -F model="openai/gpt-4o-transcribe"
Жауап
{
  "text": "Hello, welcome to AI Router!"
}

Қолдау көрсетілетін аудио-форматтар

.mp3.mp4.mpeg.mpga.m4a.wav.webm

Максималды файл өлшемі: 25 МБ

GET /api/v1/models

Барлық қолжетімді модельдерді тізіу. ID, бағалар, контекст ұзындықтарын және мүмкіндіктерін қайтарады. Аутентификация қажет емес.

cURL
curl https://api.airouter.kz/api/v1/models
Жауап (қысқартылған)
{
  "object": "list",
  "data": [
    {
      "id": "openai/gpt-5.4",
      "object": "model",
      "created": 1713200000,
      "owned_by": "openai",
      "pricing": {
        "prompt": "0.0000025",
        "completion": "0.000020"
      },
      "context_length": 1048576,
      "top_provider": {
        "max_completion_tokens": 131072
      }
    }
  ]
}

GET /api/v1/generation?id=

Нақты генерация туралы мәліметтерді алыңыз: токен санақтары, құны, кідіріс және сұранысты өңдеген провайдер.

cURL
curl "https://api.airouter.kz/api/v1/generation?id=gen-abc123" \
  -H "Authorization: Bearer air_live_your_key_here"
Жауап
{
  "id": "gen-abc123",
  "model": "openai/gpt-5.4",
  "created_at": "2026-04-15T10:30:00Z",
  "tokens_prompt": 25,
  "tokens_completion": 150,
  "total_cost": 0.003062,
  "latency_ms": 1250,
  "provider": "openai",
  "status": "completed"
}

GET /api/v1/credits

Ағымдағы балансты тексеру. OpenRouter үйлесімділігі үшін балансты USD-де жылжымалы нүктелі сан ретінде қайтарады.

cURL
curl https://api.airouter.kz/api/v1/credits \
  -H "Authorization: Bearer air_live_your_key_here"
Жауап
{
  "data": {
    "total_credits": 100.00,
    "total_usage": 23.45,
    "remaining": 76.55
  }
}

API кілттерін басқару

API-кілттерді бағдарламалық түрде жасау, тізу, жаңарту және өшіру. Session-аутентификация (панельге кіру) немесе management API-кілт қажет.

Жаңа API-кілт жасау
curl -X POST https://api.airouter.kz/api/v1/keys \
  -H "Authorization: Bearer air_live_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "production-backend",
    "rate_limit": 100
  }'
Барлық кілттерді алу
curl https://api.airouter.kz/api/v1/keys \
  -H "Authorization: Bearer air_live_your_key_here"
Кілтті өшіру
curl -X DELETE https://api.airouter.kz/api/v1/keys/key_id_here \
  -H "Authorization: Bearer air_live_your_key_here"

Self-hosted модельдер

AI Router өз GPU-инфрақұрылымымызда оптимизацияланған inference-стек арқылы 20 танымал open-weight модельді іске қосады. Бұл модельдер бірдей API қолданады — арнайы конфигурация қажет емес.

Модель ID форматы

Self-hosted модельдердің ID-сі airouter-cloud/ префиксімен басталады. Мысалдар:

  • airouter-cloud/llama-4-maverick
  • airouter-cloud/qwen-3-235b
  • airouter-cloud/deepseek-v3.2
  • airouter-cloud/gemma-3-27b
  • airouter-cloud/mistral-large-3
Python — self-hosted модельді пайдалану
from openai import OpenAI

client = OpenAI(
    base_url="https://api.airouter.kz/api/v1",
    api_key="air_live_your_key_here"
)

response = client.chat.completions.create(
    model="airouter-cloud/llama-4-maverick",
    messages=[
        {"role": "user", "content": "Write a quicksort in Python"}
    ]
)

print(response.choices[0].message.content)

Деректер жергілікті қалады

Сіздің деректеріңіз серверлерімізден шықпайды. Self-hosted модельдер үшін үшінші тарап маршруты жоқ.

Бөлінген GPU

Модельдер кепілденген есептеу қуатымен бөлінген NVIDIA GPU-ларда жұмыс істейді.

Кастомды орналастыру

Нақты модель керек пе? Кез келген HuggingFace модельді 24 сағатта орналастырамыз.

Барлық қолжетімді self-hosted модельдер — Self-Hosted бетінде.

Қателерді өңдеу

AI Router OpenAI қателер форматымен үйлесімді стандартты HTTP коды және JSON қатесін қайтарады.

СтатусМағынасы
400Bad request — жарамсыз JSON немесе міндетті өрістер жоқ
401Unauthorized — жарамсыз немесе жоқ API-кілт
402Payment required — балансте қаражат жеткіліксіз
404Not found — белгісіз модель немесе эндпоинт
429Rate limited — секундына тым көп сұраныс
500Internal error — күтпеген сервер қатесі
502Provider error — upstream провайдер қате қайтарды
503Provider unavailable — upstream провайдер қолжетімсіз
Қате жауабының форматы
{
  "error": {
    "message": "Insufficient credits. Please add funds to your account.",
    "type": "insufficient_credits",
    "code": 402
  }
}

Rate limits

Rate limits әр API-кілтке қолданылады. Әдепкі лимиттерді панель немесе API арқылы кілт бойынша теңшеуге болады.

Әдепкі лимиттер

  • Кілт бойынша минутына 60 сұраныс (теңшеледі)
  • Rate limit тақырыптары әр жауапта: X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset
  • Лимит асқанда Retry-After тақырыбымен 429 статус қайтарылады

Жоғары лимиттер керек пе? Байланыс формасын ашыңыз кастомды баптау үшін.

Интеграциялауға дайынсыз ба?

Аккаунт жасап, API-шақыруларды минуттарда бастаңыз.

API-кілтті алуҚолжетімді модельдерді қарау →