Документация Ox Alpha
OpenAI-совместимый API флагманской мультимодальной reasoning-модели Stealth. Один ключ — чат, код, изображения, аудио и видео.
Быстрый старт
Получите ключ в консоли — ключи начинаются с stealth-. Затем выполните первый запрос:
curl https://api.stealthoxalpha.ru/v1/chat/completions \ -H "Authorization: Bearer stealth-YOUR_KEY" \ -H "Content-Type: application/json" \ -d '{ "model": "stealth-ox-alpha", "messages": [{"role": "user", "content": "Hello, Ox Alpha"}] }'
from openai import OpenAI client = OpenAI( base_url="https://api.stealthoxalpha.ru/v1", api_key="stealth-YOUR_KEY", ) resp = client.chat.completions.create( model="stealth-ox-alpha", messages=[{"role": "user", "content": "Hello, Ox Alpha"}], ) print(resp.choices[0].message.content)
Аутентификация
Каждый запрос требует заголовок Authorization: Bearer <ключ>. Ключ выдаётся в консоли после пополнения баланса и начинается с stealth-.
Модели
| ID | Контекст | Модальности | Цена / 1M |
|---|---|---|---|
| stealth-ox-alpha | 1M | текст · изображения · аудио · видео | $0.15 |
Список доступных моделей: GET /v1/models.
Chat Completions
POST /v1/chat/completions — основной endpoint. Полностью совместим с OpenAI Chat API.
| Параметр | Тип | Описание |
|---|---|---|
| model | string | stealth-ox-alpha |
| messages | array | История диалога: system / user / assistant |
| stream | boolean | true — ответ по частям (SSE) |
| reasoning | object | {"effort": "low" | "medium" | "high"} — усилие мышления |
| max_tokens | integer | Лимит токенов ответа (до 64K) |
| temperature | number | 0–2, по умолчанию 1 |
Усилие мышления
Ox Alpha рассуждает перед ответом. Параметр reasoning.effort управляет глубиной — и стоимостью — мышления:
| Усилие | Когда использовать |
|---|---|
| low | Быстрые ответы, простые задачи, чат |
| medium | По умолчанию. Баланс скорости и качества |
| high | Сложный код, математика, многошаговые рассуждения |
curl https://api.stealthoxalpha.ru/v1/chat/completions \ -H "Authorization: Bearer stealth-YOUR_KEY" \ -H "Content-Type: application/json" \ -d '{ "model": "stealth-ox-alpha", "messages": [{"role": "user", "content": "Prove that √2 is irrational"}], "reasoning": {"effort": "high"} }'
Цепочка рассуждений возвращается в поле message.reasoning ответа.
Мультимодальность
Передавайте изображения, аудио и видео прямо в сообщениях — как массив частей контента:
resp = client.chat.completions.create(
model="stealth-ox-alpha",
messages=[{
"role": "user",
"content": [
{"type": "text", "text": "Что на этом изображении?"},
{"type": "image_url",
"image_url": {"url": "data:image/png;base64,..."}},
],
}],
)
{"type": "input_audio",
"input_audio": {"data": "<base64>", "format": "mp3"}}
{"type": "video_url",
"video_url": {"url": "data:video/mp4;base64,..."}}
Стриминг
Установите "stream": true — ответ придёт частями по SSE. Сначала стримится мышление (delta.reasoning), затем ответ (delta.content).
stream = client.chat.completions.create(
model="stealth-ox-alpha",
messages=[{"role": "user", "content": "Write a haiku"}],
stream=True,
extra_body={"reasoning": {"effort": "medium"}},
)
for chunk in stream:
delta = chunk.choices[0].delta
print(delta.content or "", end="")
Ошибки
| Код | Значение |
|---|---|
| 401 | Неверный или отозванный ключ |
| 402 | Баланс исчерпан — пополните в консоли |
| 403 | Модель не входит в тариф ключа |
| 429 | Превышен лимит запросов — повторите позже |
| 503 | Модель временно недоступна — токены не списаны |
Cursor
Settings → Models → добавьте модель stealth-ox-alpha и укажите OpenAI-совместимый Base URL:
Base URL: https://api.stealthoxalpha.ru/v1 API Key: stealth-YOUR_KEY Model: stealth-ox-alpha
Claude Code
Укажите переменные окружения:
export ANTHROPIC_BASE_URL="https://api.stealthoxalpha.ru" export ANTHROPIC_AUTH_TOKEN="stealth-YOUR_KEY" export ANTHROPIC_MODEL="stealth-ox-alpha"
OpenCode
Добавьте провайдера в конфиг (~/.config/opencode/opencode.json или %APPDATA%\opencode\opencode.json на Windows):
{
"provider": {
"stealth": {
"npm": "@ai-sdk/openai-compatible",
"name": "Stealth",
"options": {
"baseURL": "https://api.stealthoxalpha.ru/v1",
"apiKey": "stealth-YOUR_KEY"
},
"models": {
"stealth-ox-alpha": { "name": "Ox Alpha" }
}
}
}
}