Справочник API CheapAI
Базовые адреса CheapAI, авторизация, эндпоинты OpenAI, Anthropic и Gemini, стриминг и проверка баланса.
Какой API выбрать
Форматы, доступные для вашей модели, указаны в каталоге. Каталог моделей
| Клиент | Базовый адрес | Маршрут | Авторизация |
|---|---|---|---|
| OpenAI SDK | https://cheapai.io/v1 | /v1/chat/completions | Authorization: Bearer |
| Codex | https://cheapai.io/v1 | /v1/responses | Authorization: Bearer |
| Claude Code и Anthropic SDK | https://cheapai.io | /v1/messages | x-api-key |
| Google Gemini SDK | https://cheapai.io | /v1beta/models/{model}:generateContent | x-goog-api-key |
Base URL
Адреса два, и отличаются они ровно одним: стоит ли перед ними CDN. Всё остальное — ключи, модели, цены, формат запроса — одинаковое.
524 прямой адрес позволяет подключиться к шлюзу в обход таймаута CDN. Таймауты шлюза и клиента продолжают действовать.При смене адреса используйте базовый URL из таблицы и замените только домен. Claude Code, Anthropic SDK и Gemini SDK получают адрес без суффикса /v1.
Аутентификация
Один ключ CheapAI работает со всеми поддерживаемыми протоколами. Выберите заголовок авторизации из таблицы в зависимости от интерфейса.
# OpenAI-style
Authorization: Bearer sk-...
# Anthropic-style
x-api-key: sk-.../v1/chat/completionsChat Completions для диалоговых моделей с поддержкой OpenAI-совместимого формата. Для стриминга передайте stream: true.
curl https://cheapai.io/v1/chat/completions \
-H "Authorization: Bearer $CHEAPAI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "claude-sonnet-4-6",
"messages": [
{"role": "user", "content": "Hi!"}
]
}'import OpenAI from "openai";
const client = new OpenAI({
apiKey: process.env.CHEAPAI_API_KEY,
baseURL: "https://cheapai.io/v1",
});
const res = await client.chat.completions.create({
model: "claude-sonnet-4-6",
messages: [{ role: "user", content: "Hi!" }],
});
console.log(res.choices[0].message);Структура ответа
{
"id": "chatcmpl-...",
"object": "chat.completion",
"model": "claude-sonnet-4-6",
"choices": [{
"index": 0,
"message": { "role": "assistant", "content": "..." },
"finish_reason": "stop"
}],
"usage": {
"prompt_tokens": 10,
"completion_tokens": 42,
"total_tokens": 52
}
}/v1/responsesЭтот интерфейс использует Codex. Выберите модель с поддержкой Responses API. Текст запроса передаётся в поле input, а параметр stream: true включает поток событий.
curl https://cheapai.io/v1/responses \
-H "Authorization: Bearer $CHEAPAI_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"grok-4.5","input":"Reply with OK."}'/v1/messagesAnthropic-нативный Messages API. Используйте для Claude-моделей, когда нужны extended thinking, нативные tool_use блоки, prompt caching или любые Claude-специфичные параметры.
curl https://cheapai.io/v1/messages \
-H "x-api-key: $CHEAPAI_API_KEY" \
-H "anthropic-version: 2023-06-01" \
-H "Content-Type: application/json" \
-d '{
"model": "claude-sonnet-4-6",
"max_tokens": 1024,
"messages": [
{"role": "user", "content": "Hi!"}
]
}'import Anthropic from "@anthropic-ai/sdk";
const client = new Anthropic({
apiKey: process.env.CHEAPAI_API_KEY,
baseURL: "https://cheapai.io",
});
const res = await client.messages.create({
model: "claude-sonnet-4-6",
max_tokens: 1024,
messages: [{ role: "user", content: "Hi!" }],
});
console.log(res.content);Структура ответа
{
"id": "msg_...",
"type": "message",
"role": "assistant",
"content": [{ "type": "text", "text": "..." }],
"model": "claude-sonnet-4-6",
"stop_reason": "end_turn",
"usage": {
"input_tokens": 10,
"output_tokens": 42,
"cache_read_input_tokens": 0,
"cache_creation_input_tokens": 0
}
}/v1/modelsСписок моделей, доступных под вашим ключом (envelope в стиле OpenAI).
curl https://cheapai.io/v1/models \
-H "Authorization: Bearer $CHEAPAI_API_KEY"/v1/images/generationsГенерация картинок. Списывается за вызов, а не за токены — цена указана на странице моделей.
curl https://cheapai.io/v1/images/generations \
-H "Authorization: Bearer $CHEAPAI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-image-2.5",
"prompt": "a lighthouse at dusk, long exposure",
"n": 1
}'Модель из примера генерирует изображение по тексту. Для работы с входным изображением проверьте возможности модели в каталоге. Например, Gemini Flash Image принимает изображение в мультимодальном сообщении через /v1/chat/completions.
/v1beta/models/{model}:generateContentНативный Gemini API. Нужен для grounding через google_search — в OpenAI-совместимом пути аналога нет.
curl https://cheapai.io/v1beta/models/gemini-3.1-pro-preview:generateContent \
-H "x-goog-api-key: $CHEAPAI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"contents": [{"parts": [{"text": "What changed in the news today?"}]}],
"tools": [{"google_search": {}}]
}'Аутентификация здесь через x-goog-api-key, как ждут Google-SDK — ключ тот же, что и везде. Стриминг — :streamGenerateContent. У ответов с grounding приходит блок groundingMetadata со списком источников.
/v1/balanceОстаток по API-ключу одним запросом: кошелёк, подписка и сколько этим ключом ещё можно потратить.
curl https://cheapai.io/v1/balance \
-H "Authorization: Bearer $CHEAPAI_API_KEY"
# → {
# "available_usd": 166.52, // сколько этим ключом ещё можно потратить
# "balance_usd": 12.34, // кошелёк
# "subscription": {"plan": "Pro", "remaining_usd": 154.18, "total_usd": 157.61, "expires_at": "2026-12-14T11:24:16Z"},
# "used_usd": 34.43,
# "key": {"name": "my-key", "unlimited": true, "used_usd": 3.21, "limit_usd": null, "remaining_usd": null, "expires_at": null},
# "scope": "account", "currency": "USD"
# }/v1/dashboard/billing/subscriptionБаланс и расход в OpenAI-совместимом формате — готовые инструменты читают его без переделок.
# всего доступно (остаток + уже потрачено), USD
curl https://cheapai.io/v1/dashboard/billing/subscription \
-H "Authorization: Bearer $CHEAPAI_API_KEY"
# → {"hard_limit_usd": 148.51, "access_until": 0, …}
# потрачено, в сотых долях доллара
curl https://cheapai.io/v1/dashboard/billing/usage \
-H "Authorization: Bearer $CHEAPAI_API_KEY"
# → {"total_usage": 7639.53} // = $76.40Стриминг
Передайте "stream": true в теле запроса и ответ придёт server-sent-event потоком. Для /v1/chat/completions формат — OpenAI SSE (чанки data: {…}, терминатор data: [DONE]). Для /v1/messages формат — Anthropic SSE (типизированные события: message_start, content_block_delta, message_stop).
Ошибки
Ошибки следуют формату upstream-провайдера. HTTP-код отражает класс сбоя.
| HTTP | Значение |
|---|---|
| 400 | Неверный запрос — модель, параметры, схема. |
| 401 | Нет ключа или ключ невалидный. |
| 402 | Баланса не хватает — пополните, чтобы продолжить. |
| 429 | Лимит upstream-провайдера. Повторите позже. |
| 5xx | Сбой upstream — возможен повтор через резервный канал. |
Таймауты и стриминг
Перед началом ответа отдельно действуют таймауты клиента и шлюза. Для длинных запросов используйте "stream": true там, где доступен SSE. В потоке действуют свои лимиты бездействия. Служебный ping поддерживает соединение, а события с текстом, рассуждением или инструментом показывают прогресс генерации.