CheapAI

Справочник API CheapAI

Базовые адреса CheapAI, авторизация, эндпоинты OpenAI, Anthropic и Gemini, стриминг и проверка баланса.

Какой API выбрать

Форматы, доступные для вашей модели, указаны в каталоге. Каталог моделей

КлиентБазовый адресМаршрутАвторизация
OpenAI SDKhttps://cheapai.io/v1/v1/chat/completionsAuthorization: Bearer
Codexhttps://cheapai.io/v1/v1/responsesAuthorization: Bearer
Claude Code и Anthropic SDKhttps://cheapai.io/v1/messagesx-api-key
Google Gemini SDKhttps://cheapai.io/v1beta/models/{model}:generateContentx-goog-api-key

Base URL

Адреса два, и отличаются они ровно одним: стоит ли перед ними CDN. Всё остальное — ключи, модели, цены, формат запроса — одинаковое.

Основной — за CDN
https://cheapai.io/v1
Прямой — без CDN
https://api.cheapai.io/v1
При HTTP 524 прямой адрес позволяет подключиться к шлюзу в обход таймаута CDN. Таймауты шлюза и клиента продолжают действовать.

При смене адреса используйте базовый URL из таблицы и замените только домен. Claude Code, Anthropic SDK и Gemini SDK получают адрес без суффикса /v1.

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

Один ключ CheapAI работает со всеми поддерживаемыми протоколами. Выберите заголовок авторизации из таблицы в зависимости от интерфейса.

bash
# OpenAI-style
Authorization: Bearer sk-...

# Anthropic-style
x-api-key: sk-...
POST/v1/chat/completions

Chat Completions для диалоговых моделей с поддержкой OpenAI-совместимого формата. Для стриминга передайте stream: true.

bash
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!"}
    ]
  }'
javascript
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
  }
}
POST/v1/responses

Этот интерфейс использует Codex. Выберите модель с поддержкой Responses API. Текст запроса передаётся в поле input, а параметр stream: true включает поток событий.

bash
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."}'
POST/v1/messages

Anthropic-нативный Messages API. Используйте для Claude-моделей, когда нужны extended thinking, нативные tool_use блоки, prompt caching или любые Claude-специфичные параметры.

bash
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!"}
    ]
  }'
javascript
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
  }
}
GET/v1/models

Список моделей, доступных под вашим ключом (envelope в стиле OpenAI).

bash
curl https://cheapai.io/v1/models \
  -H "Authorization: Bearer $CHEAPAI_API_KEY"
POST/v1/images/generations

Генерация картинок. Списывается за вызов, а не за токены — цена указана на странице моделей.

bash
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.

POST/v1beta/models/{model}:generateContent

Нативный Gemini API. Нужен для grounding через google_search — в OpenAI-совместимом пути аналога нет.

bash
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 со списком источников.

Если сконвертировать этот tool в OpenAI-шные function_declarations, grounding отваливается — ради этого эндпоинт и существует отдельно. Если нужен просто чат, Gemini-модели прекрасно работают и через /v1/chat/completions.
GET/v1/balance

Остаток по API-ключу одним запросом: кошелёк, подписка и сколько этим ключом ещё можно потратить.

bash
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"
# }
Ключ без лимита показывает аккаунт целиком (scope: account). Ключ с лимитом показывает только свой лимит и остаток (scope: key) — баланс аккаунта через него не виден. Ключ передаётся только в заголовке; не чаще 60 запросов в минуту на ключ.
GET/v1/dashboard/billing/subscription

Баланс и расход в OpenAI-совместимом формате — готовые инструменты читают его без переделок.

bash
# всего доступно (остаток + уже потрачено), 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
hard_limit_usd — это НЕ остаток, а остаток плюс уже потраченное: так устроено поле в исходном формате OpenAI. Остаток считается как hard_limit_usd − total_usage / 100. В примере выше: 148.51 − 76.40 = $72.11. Остаток включает квоту подписки; у ключа с лимитом числа считаются по ключу.

Стриминг

Передайте "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 — возможен повтор через резервный канал.

Как реагировать на 429, 503 и обрыв потока

Таймауты и стриминг

Перед началом ответа отдельно действуют таймауты клиента и шлюза. Для длинных запросов используйте "stream": true там, где доступен SSE. В потоке действуют свои лимиты бездействия. Служебный ping поддерживает соединение, а события с текстом, рассуждением или инструментом показывают прогресс генерации.