FAQ для разработчиков

Короткие ответы на частые вопросы по API. Если нужного нет — загляните в справочник API или коды ошибок.

Это правда drop-in замена OpenAI API?

Да. Меняете base_url на https://api.cheapai.io/v1 и ключ на cai-... — остальной код не трогаете. Эндпоинты, параметры и формат ответа те же. Провайдер-специфичные параметры передаются модели как есть; если конкретная модель чего-то не умеет — она ответит ошибкой так же, как ответила бы напрямую.

Какие модели доступны?

В каталоге весь каталог моделей — OpenAI, Anthropic, Google, DeepSeek и другие. На странице каталога перечислены популярные с ценами; имя модели из каталога подставляется в поле model. Список и цены могут меняться — ориентируйтесь на каталог.

Работает ли стриминг?

Да — "stream": true, ответ приходит чанками в формате SSE, поток завершается data: [DONE]. Пример — в справочнике.

Поддерживаются ли function calling, tool use и vision?

Это зависит от модели, а не от шлюза: запрос с tools / tool_choice или с изображениями в content передаётся провайдеру, и модель отвечает в своём формате. Какие возможности у модели — видно по тегам в каталоге (chat, vision, embeddings и т. д.).

Один ключ работает со всеми моделями?

Да. Ключ не привязан к модели или провайдеру — одним ключом ходите хоть в gpt-4o, хоть в claude-3-5-sonnet. Баланс общий на аккаунт; ключей можно завести несколько (удобно по проектам) и отзывать по отдельности — см. API-ключи.

Нужен ли VPN?

Нет. Запросы идут на api.cheapai.io — модели отвечают через шлюз. Это работает и для API, и для CLI-агентов вроде Claude Code и Codex.

Какие лимиты по частоте?

У каждой модели свой лимит запросов в минуту. При превышении приходит 429 — повторите запрос с экспоненциальной задержкой (официальные SDK делают это сами). Подробнее — Коды ошибок.

Чем считается стоимость запроса?

По токенам из поля usage в ответе и тарифу модели (отдельно вход и выход). Абонплаты нет — платите по факту использования. Тарифы и формула — на странице Тарификация, расход по каждому запросу — в истории в кабинете.

Запрос вернул ошибку — где смотреть, что не так?

Сначала — HTTP-статус и поле error.message в теле ответа: там конкретная причина. Расшифровка статусов и что делать с каждым — на странице .