chad API
Используйте chad в своих программах или приложениях. Новый OpenAI-совместимый API chad можно подключать в большинство интеграций сервисов/плагинов/конструкторов ботов/расширений как замену ChatGPT API-ключа
Что это и как работает
Вы отправляете HTTP POST-запрос с сообщениями и получаете ответ модели:
- обычный JSON (
stream=false) - поток SSE (
stream=true)
Не поддерживается работа с вашими чатами и шаблонами. Запросы, отправленные через API, не будут видны в списке ваших чатов в интерфейсе chad
Как начать?
В личном кабинете нужно перейти в меню «Управление API» и получить ваш персональный API-ключ
Создать ключПополнить рублями API баланс - счет для списывания оплаты api запросов
Если у вас есть активная подписка chad с непотраченными искрами и нет рублей на API балансе, будут тратиться искры. Однако, конвертация будет по менее выгодному курсу, поэтому с API рекомендуем работать именно через пополнение баланса.
Отправить запрос, используя любой удобный вам язык программирования, и получить сообщение с ответом
Смотрите ниже, как
Тарификация
Как списывается оплата
- Личный аккаунт: сначала списание идет с
API баланса(рубли). Если личного баланса не хватает, остаток списывается в искрах по текущему курсу (Личный кабинет -> Управление API). Если искр недостаточно, не покрытая часть суммы записывается в долг (личныйAPI балансможет уйти в минус) - Компания: полная стоимость запроса списывается с
API балансакомпании (если баланса компании не хватает, она так же уходит в минус) - Семейная подписка: доступные искры/рубли для участника берутся из семейного лимита владельца (если семья активна)
- Стоимость рассчитывается по фактически использованным моделью токенам, цена за токены ввода и вывода разная для разных моделей, кэширование токенов на данный момент не учитывается
Если денег/лимита не хватает
- Личный или семейный аккаунт: запрос пройдет, только если хватает доступного лимита слов; иначе вернется ошибка
429-insufficient_quota - Компания: если у компании нулевой или отрицательный
API балансдо запроса, вернется ошибка429-insufficient_quota - Если у компании баланс был положительный, но меньше стоимости конкретного запроса, запрос выполнится, а баланс может уйти в минус
Поддерживаемые ссылки
https://ask.chadgpt.ru/api/v1/chat/completionshttps://ask.chadgpt.ru/api/v1/models
Быстрый старт API
- Получите API-ключ в личном кабинете
- Передавайте ключ в заголовке запроса
Authorization: Bearer <API_KEY> - Отправляйте openAI-совместимый запрос на
https://ask.chadgpt.ru/api/v1/chat/completions - Список доступных моделей можно получить на
https://ask.chadgpt.ru/api/v1/models
Важно сразу
- Для этого маршрута используются OpenAI text-модели
- Сервер принимает OpenAI-совместимые параметры запроса и передает их в upstream-модель (если поле поддерживается форматом OpenAI payload)
- Модели API пока не поддерживают обработку картинок
- Поле
api_keyв body передавать нельзя
Список моделей
Эндпоинт GET /api/v1/models:
- проверяет API-ключ
- возвращает список моделей, доступных по текущей серверной конфигурации
- пример запроса можно посмотреть ниже
Текущие модели
Стоимость использования моделей указана в рублях за миллион токенов модели (RUB / 1М)
| ID | Название | Вход | Выход |
|---|---|---|---|
| gpt-5 | GPT 5 | 160.00 | 1280.00 |
| gpt-5-thinking | GPT 5 THINKING | 160.00 | 1280.00 |
| gpt-5.1 | GPT 5.1 | 160.00 | 1280.00 |
| gpt-5.2 | GPT 5.2 | 224.00 | 1792.00 |
| gpt-5.2-thinking | GPT 5.2 THINKING | 224.00 | 1792.00 |
| gpt-5.3-codex | GPT 5.3 CODEX | 224.00 | 1792.00 |
| gpt-5.5 | GPT 5.5 | 640.00 | 3840.00 |
| gpt-5.6-sol | GPT 5.6 SOL | 640.00 | 3840.00 |
| gpt-5.6-sol-pro | GPT 5.6 SOL PRO | 640.00 | 3840.00 |
| gpt-5.6-terra | GPT 5.6 TERRA | 320.00 | 1920.00 |
| gpt-5.6-luna | GPT 5.6 LUNA | 128.00 | 768.00 |
| gpt-5-mini | GPT 5 MINI | 32.00 | 256.00 |
| gpt-5-nano | GPT 5 NANO | 6.40 | 51.20 |
| gemini-2.5-pro | GEMINI 2.5 PRO | 160.00 | 1280.00 |
| gemini-2.5-flash | GEMINI 2.5 FLASH | 38.40 | 320.00 |
| gemini-3.1-pro-preview | GEMINI 3.1 PRO PREVIEW | 384.00 | 1920.00 |
| gemini-3-flash-preview | GEMINI 3 FLASH PREVIEW | 64.00 | 384.00 |
| gemini-3.5-flash | GEMINI 3.5 FLASH | 192.00 | 1152.00 |
| gemini-3.6-flash | GEMINI 3.6 FLASH | 192.00 | 960.00 |
| gemini-3.1-flash-lite-preview | GEMINI 3.1 FLASH LITE PREVIEW | 32.00 | 192.00 |
| gemini-3.5-flash-lite | GEMINI 3.5 FLASH LITE | 38.40 | 320.00 |
| claude-4-opus | CLAUDE 4 OPUS | 1920.00 | 9600.00 |
| claude-4.1-opus | CLAUDE 4.1 OPUS | 1920.00 | 9600.00 |
| claude-4.5-opus | CLAUDE 4.5 OPUS | 640.00 | 3200.00 |
| claude-4.6-opus | CLAUDE 4.6 OPUS | 640.00 | 3200.00 |
| claude-4.7-opus | CLAUDE 4.7 OPUS | 640.00 | 3200.00 |
| claude-4.8-opus | CLAUDE 4.8 OPUS | 640.00 | 3200.00 |
| claude-5-opus | CLAUDE 5 OPUS | 640.00 | 3200.00 |
| claude-5-fable | CLAUDE 5 FABLE | 1280.00 | 6400.00 |
| claude-4-sonnet | CLAUDE 4 SONNET | 384.00 | 1920.00 |
| claude-4-sonnet-thinking | CLAUDE 4 SONNET THINKING | 384.00 | 1920.00 |
| claude-4.5-sonnet | CLAUDE 4.5 SONNET | 384.00 | 1920.00 |
| claude-4.5-sonnet-thinking | CLAUDE 4.5 SONNET THINKING | 384.00 | 1920.00 |
| claude-5-sonnet | CLAUDE 5 SONNET | 384.00 | 1920.00 |
| claude-5-sonnet-thinking | CLAUDE 5 SONNET THINKING | 384.00 | 1920.00 |
| claude-4.5-haiku | CLAUDE 4.5 HAIKU | 128.00 | 640.00 |
| deepseek-v4-flash | DEEPSEEK v4 FLASH | 17.92 | 35.84 |
| deepseek-v4-pro | DEEPSEEK v4 PRO | 222.72 | 445.44 |
| glm-5.2 | GLM 5.2 | 125.44 | 394.24 |
| kimi-k3 | KIMI k3 | 384.00 | 1920.00 |
| grok-4-latest | GROK 4 LATEST | 384.00 | 1920.00 |
| grok-4-with-web-search | GROK 4 WITH WEB SEARCH | 384.00 | 1920.00 |
| grok-4-fast-latest | GROK 4 FAST LATEST | 38.40 | 64.00 |
| grok-4-fast-with-web-search | GROK 4 FAST WITH WEB SEARCH | 38.40 | 64.00 |
| grok-4.1-fast-latest | GROK 4.1 FAST LATEST | 38.40 | 64.00 |
| grok-4.1-fast-with-web-search | GROK 4.1 FAST WITH WEB SEARCH | 38.40 | 64.00 |
| grok-4.5 | GROK 4.5 | 256.00 | 768.00 |
| grok-4.5-with-web-search | GROK 4.5 WITH WEB SEARCH | 256.00 | 768.00 |
| grok-4.5-thinking | GROK 4.5 THINKING | 256.00 | 768.00 |
| grok-4.5-thinking-with-web-search | GROK 4.5 THINKING WITH WEB SEARCH | 256.00 | 768.00 |
| text-embedding-3-small | TEXT EMBEDDING 3 SMALL | 2.56 | 0.00 |
Допустимые параметры запроса
Заголовки POST /api/v1/chat/completions
| Поле | Тип | Описание |
|---|---|---|
| Authorization | string | Bearer-токен в формате Bearer <API_KEY> (обязательно) |
| Content-Type | string | Обычно application/json |
Тело запроса (application/json)
| Поле | Тип | Описание |
|---|---|---|
| model | string | ID модели из /api/v1/models (обязательно) |
| messages | array<object> | Непустой массив сообщений (обязательно) |
| stream | boolean | Если true, ответ идет как text/event-stream |
| stream_options | object | Параметры stream-режима; работает только при stream=true. Если include_usage не передан, сервер добавляет include_usage=true |
| max_tokens | integer | Рекомендуемый лимит output-токенов |
| temperature | number | Параметр семплирования OpenAI-совместимого payload |
| top_p | number | Параметр nucleus sampling OpenAI-совместимого payload |
| tools | array<object> | Инструменты в OpenAI-совместимом формате |
| tool_choice | string или object | Режим выбора tool в OpenAI-совместимом формате |
Формат messages[]
| Поле | Тип | Описание |
|---|---|---|
| role | string | Роль сообщения (system, user, assistant, tool) |
| content | string или array<object> | Текст сообщения или массив контент-частей |
Пример content как string:
Пример content как array<object>:
Что передавать нельзя?
api_key в JSON body как в старой весии api. Если передать api_key в body, вернется 400 invalid_request_error.
Примеры запросов
Обычный запрос (Python)
Stream-запрос (Python)
Библиотека OpenAI
Список моделей (Python)
Формат ответов
Успешный ответ
choices[]
usage
Stream-ответ (stream=true)
Формат: text/event-stream.
Пример событий:
Что забирать клиенту из stream:
- берите
choices[0].delta.contentв каждом чанке, где поле присутствует; - склеивайте эти фрагменты в финальный текст ответа.
Ошибки и формат error-ответа
Формат error-объекта
Реальные сценарии для POST /api/v1/chat/completions
| HTTP | error.type | Когда возникает |
|---|---|---|
| 400 | invalid_request_error | Невалидный JSON, body не объект, ошибки полей (model, messages, api_key в body и др.) |
| 401 | invalid_request_error | Нет Authorization или неверный формат заголовка |
| 401 | invalid_api_key | API-ключ не найден или невалиден |
| 403 | permission_denied | Доступ запрещен |
| 429 | insufficient_quota | Закончилась доступная квота |
| 502 | server_error | Upstream OpenAI недоступен или вернул сбой |
| 500 | server_error | Непредвиденная ошибка сервиса |
