Документация API.
Ключ, адрес API и модель — всё, что нужно для подключения. Остаток и история запросов — в личном кабинете.
Начало работы
- Откройте личный кабинет и вставьте выданный токен вида
tpk_…. Логин, пароль и регистрация не нужны. - Проверьте остаток пакета. В каждый пакет входят все модели каталога; токен открывает только свой пакет.
- Используйте этот же токен как API-ключ в программе. Сохраните его при получении заказа.
- Проверьте подключение и посмотрите расход в истории запросов.
Настройки AI-клиента
Если клиент поддерживает OpenAI-совместимое подключение, укажите эти параметры.
- Base URL
https://cheapdev.ru/v1Для Claude Code и Anthropic SDK — https://cheapdev.ru без /v1- API key
- Тот же выданный токен, по которому вы входите в кабинет
- Model
- Точный Model ID текстовой модели из каталога
- Протоколы
- Chat Completions, Anthropic Messages и Responses: текст, история и инструменты клиента
- Поток
stream:trueпринимается; SSE приходит после полного ответа модели и учёта расхода
Картинки на входе принимаются: PNG, JPEG, GIF и WebP, до 5 на запрос, до 5 МБ каждая. Файлы и PDF, режим рассуждений, встроенный веб-поиск и серверные инструменты пока не поддерживаются.
OpenCode
В opencode.json добавьте собственного провайдера с OpenAI-совместимым SDK. Перед запуском задайте переменную окружения CHEAPDEV_API_KEY со своим токеном пакета; не сохраняйте токен в файле проекта. Пример для модели deepseek-v4-flash:
{
"$schema": "https://opencode.ai/config.json",
"model": "cheapdev/deepseek-v4-flash",
"provider": {
"cheapdev": {
"npm": "@ai-sdk/openai-compatible",
"name": "CheapDev",
"options": {
"baseURL": "https://cheapdev.ru/v1",
"apiKey": "{env:CHEAPDEV_API_KEY}"
},
"models": {
"deepseek-v4-flash": { "name": "DeepSeek V4 Flash" }
}
}
}
}Chat Completions принимает вызовы функций и потоковый формат OpenCode. События SSE отправляются после полного ответа модели и учёта расхода, поэтому текст не появляется по мере генерации. Проверьте свой рабочий процесс на выданном пакете. Формат провайдера описан в документации OpenCode.
Пример запроса
Замените YOUR_API_KEY своим токеном, а MODEL_ID — идентификатором модели из каталога.
POST /v1/chat/completions
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json
Idempotency-Key: unique-request-id
{
"model": "MODEL_ID",
"messages": [
{ "role": "user", "content": "Привет!" }
],
"max_tokens": 256,
"stream": false
}Для каждого нового запроса указывайте новый Idempotency-Key. Начните с небольшого ограничения длины ответа. С stream:true ответ SSE начнётся после выполнения запроса моделью и учёта расхода. Тело запроса — до 8 МиБ, ответ — до 4096 токенов.
Расход токенов
Все модели расходуют общий остаток пакета. Списание зависит от множителя выбранной модели и коэффициента кэша — это стандартные множители каталога, они указаны на странице моделей. Токены пакета и фактические токены модели могут различаться.
Например, у Claude Sonnet 5 множитель ×2. Запрос с 1 200 входными и 800 выходными токенами без кэша расходует 4 000 токенов пакета. Из пакета на 1 млн останется 996 000.
Кэш уже входит во входные токены: он вычитается из обычного входа и учитывается один раз по коэффициенту кэша. У моделей Claude коэффициент кэша ×0,1: повторно отправленный контекст (например, история диалога в Claude Code) списывается в 10 раз дешевле. У остальных текстовых моделей ×1. Токены рассуждения уже входят в выходные и повторно не добавляются.
В истории отдельно показаны вход, выход, кэш, фактическая сумма токенов модели, множитель и списание из пакета. Дробные списания и остатки отображаются с точностью до 6 знаков после запятой.
Для выполняющегося запроса часть токенов пакета находится в резерве; он показан отдельно от доступного остатка. Переключение между моделями не требует нового токена. Остатки разных пакетов можно перенести в кабинете, предъявив оба токена и подтвердив сумму.
Безопасность ключа
Полный токен выдаётся вместе с пакетом. Храните его в менеджере паролей или в защищённых настройках приложения. Не отправляйте его в чат заказа, не публикуйте и не вставляйте в адресную строку.
Токен открывает только свой пакет и служит API-ключом. Передавайте его только доверенным приложениям. Дополнительные ключи в кабинете не создаются.
Если токен потерян, напишите в поддержку или в переписку по заказу на площадке, не передавая туда его полное значение. При переносе остатка исходный токен отключается после вашего подтверждения.
Ошибки запроса
- Ключ не принят
- Проверьте, что скопирован весь ключ и он не отозван.
- Неверная модель
- Укажите точный Model ID из каталога. Для проверки подключения доступны текстовые модели.
- Недостаточно токенов
- Проверьте доступный остаток. Уменьшите длину ответа или выберите модель с меньшим множителем.
- Требуется проверка расхода
- Расход запроса удержан до сверки, остальной остаток доступен. Не повторяйте запрос автоматически; сохраните его идентификатор и напишите в поддержку или в переписку по заказу на площадке.