Подключение моделей
Один API‑ключ, один endpoint, все модели GPT и Gemini — нативные протоколы OpenAI и Gemini, маршрут Anthropic Messages для Claude Code и OpenAI‑совместимый API для любого клиента. AI‑агент сам настроит и проверит подключение.
Для вашего AI‑агента
Помощь с подключением
IDE, SDK, endpoint, модели и ошибки запросов.
Быстрый старт
Подключите apiToken.sale к coding agent, который читает, изменяет и запускает ваш проект. Выберите стек — точная инструкция появится ниже.
Один endpoint, все протоколы
router.apitoken.sale — единая точка входа для GPT и Gemini. Coding‑агенты и официальные SDK получают нативные API байт‑в‑байт; Claude Code работает с моделями GPT и Gemini через маршрут Anthropic Messages; любой OpenAI‑совместимый клиент работает со всеми текстовыми моделями каталога через один универсальный маршрут. Тот же ключ sk‑pool и тот же предоплаченный баланс.
API баланса и расхода
Тот же ключ, который тратит деньги, читает, на что они ушли. Один маршрут отдаёт живой баланс и точный расход за любое окно по всем провайдерам — без личного кабинета и без второго ключа.
| Параметр | Что задаёт |
|---|---|
from | Начало окна, включительно. RFC3339 UTC — 2026-08-01T00:00:00Z, явный числовой offset или голая дата 2026-08-01. По умолчанию — to минус 30 дней. |
to | Конец окна, **не включается**. Те же формы. По умолчанию — «сейчас»; будущее значение подрезается до «сейчас». |
group_by | model (по умолчанию), provider, day, day,provider, day,model или api_key. Порядок в списке не важен, а model,provider — просто псевдоним model: строка модели и так называет своего провайдера. |
Две цены, обе точные. cost — что списано с вас; list_cost — прайс провайдера за тот же трафик, разница и есть ваша скидка. Обе дублируются целой строкой *_nano. Читайте деньги как строку, никогда как float.
Только явный UTC. Локальное время без offset отклоняется: догадка о зоне молча сдвинула бы границы денежного отчёта. Окно должно быть положительным и не длиннее 366 дней, иначе придёт 400 в конверте ошибок протокола хоста (Messages, OpenAI или Gemini этого хоста), с причиной в error.message.
Разрезы сходятся. Любой разрез одного окна даёт тот же итог: все они читаются из одного согласованного снимка. Токены есть в разрезах model, provider и day,model; простые дневные разрезы несут деньги и число запросов. Разрез day,model — расход по каждой модели по дням — ограничен 92 днями и за этой границей отвечает 400, а не молча теряет строки. Ключи маскируются. GET /balance отдаёт только баланс.
Модели и цены
GPT и Gemini, все доступные модели и точные ставки за 1M токенов — официальная цена против той, что платите вы с единой скидкой 50%.
GPT · OpenAI Responses API
router.apitoken.salePOST /v1/responses · POST /v1/chat/completions| Модель | Контекст | Макс. вывод | Ввод | Кеш. ввод | Запись в кеш | Вывод |
|---|---|---|---|---|---|---|
GPT-6.1 TerraНоваяgpt-6.1-terra | 872K | 128K | $0.5 | $0.025 | $0.625 | $2.5 |
GPT-6.1 Solgpt-6.1-sol | 872K | 128K | $1 | $0.05 | $1.25 | $5 |
GPT-6 Astragpt-6-astra | 872K | 128K | $5 | $0.5 | $6.25 | $25 |
GPT-6 Solgpt-6-sol | 872K | 128K | $1 | $0.1 | $1.25 | $5 |
GPT-6 Lunagpt-6-luna | 872K | 128K | $0.05 | $0.005 | $0.0625 | $0.25 |
GPT-5.6 Solgpt-5.6-sol | 872K | 128K | $2 | $0.2 | $2.5 | $10 |
GPT-5.6 Terragpt-5.6-terra | 872K | 128K | $1 | $0.1 | $1.25 | $6 |
GPT-5.6 Lunagpt-5.6-luna | 872K | 128K | $0.1 | $0.01 | $0.125 | $0.6 |
GPT Image 2gpt-image-2 | per request | 1–10 images (n) | $2.5 | $0.625 | $0 | $15 |
GPT Image 2.5 Flaregpt-image-2.5-flare | per request | 1–10 images (n) | $2.5 | $0.625 | $0 | $15 |
GPT Image 2.5 Sunburstgpt-image-2.5-sunburst | per request | 1–10 images (n) | $2.5 | $0.625 | $0 | $15 |
GPT Image 2.6 Flaregpt-image-2.6-flare | per request | 1–10 images (n) | $2.5 | $0.625 | $0 | $15 |
GPT Image 2.6 Sunburstgpt-image-2.6-sunburst | per request | 1–10 images (n) | $2.5 | $0.625 | $0 | $15 |
Gemini · Google Gemini API
router.apitoken.salePOST /v1beta/models/{model}:generateContent| Модель | Контекст | Макс. вывод | Ввод | Кеш. ввод | Запись в кеш | Вывод |
|---|---|---|---|---|---|---|
Gemini 4 HydrogenНоваяgemini-4-hydrogen | 1M shared by input, thinking and output | 64K streaming · 32K non-streaming | $0.75 | $0.0375 | — | $3.75 |
Gemini 4 Carbongemini-4-carbon | 1M shared by input, thinking and output | 64K streaming · 32K non-streaming | $1 | $0.05 | — | $5 |
Gemini 4 Argongemini-4-argon | 1M shared by input, thinking and output | 64K streaming · 32K non-streaming | $1 | $0.05 | — | $5 |
Gemini 3.8 Flashgemini-3.8-flash | 1M | 64K | $0.375 | $0.0375 | — | $1.875 |
2M input × $1 = $2400K output × $5 = $2Официально итого = $4- Ставки указаны за 1M токенов; списание идёт за фактические токены по официальным ставкам, затем вычитается единая скидка 50%.
- Токены размышлений (thinking/reasoning) тарифицируются как вывод у обоих провайдеров.
- GPT-запросы свыше 272K входных токенов тарифицируются по официальным ставкам длинного контекста: 2× ввод и 1,5× вывод на весь запрос.
- Ставки Gemini соответствуют официальному стандартному платному тарифу Google.
- Актуальный список доступных моделей — всегда в
GET /v1/modelsна едином endpoint: один агрегированный каталог для всех провайдеров.
Как отправлять файлы в Gemini
generateContent требует inline-байты: files/… из любого Google-проекта невидим этому шлюзу. Передавайте каждый файл inline в запросе.
| Тип данных | Поддержка | Как отправлять |
|---|---|---|
| Изображения (PNG, JPEG, WebP) | Да | inline_data с mime_type и base64. Примерно до 23 МБ исходного файла. |
| PDF-документы | Да | inline_data с application/pdf. Модель читает текст внутри документа. |
| Текстовые файлы | Да | inline_data с text/plain — или просто вставьте текст в text. |
| Аудио | Все текстовые модели | Любая текстовая модель, inline audio/wav. |
Files API (file_uri / fileData) | Нет | Недоступно. Передавайте байты inline в запросе. |
cachedContent | Нет | Недоступно. Передавайте содержимое inline. |
Когда мы отказываем. Данные, которые шлюз принять не может, отклоняются до отправки провайдеру — 400 INVALID_ARGUMENT со стабильной причиной ErrorInfo: FILE_URI_UNSUPPORTED, CACHED_CONTENT_UNSUPPORTED, AUDIO_INPUT_UNSUPPORTED. Сообщение следует шаблону {field} cannot be honoured on this endpoint. The official Gemini API accepts it; {workaround}. FILE_URI_UNSUPPORTED относится к любой ссылке на файл Google. Такой отказ окончательный: помогает изменение запроса, а не повтор. В каждой ошибке есть заголовок x-request-id — назовите его поддержке, и мы найдём именно ваш запрос.
Основные коды ответа
На едином endpoint каждый протокол сохраняет свой формат ошибок: маршрут Messages возвращает JSON ошибок Anthropic (ограничения шлюза добавляют `error.details.error_code` / `param`), маршруты OpenAI — {"error":{"message","type","param","code"}}, маршрут Gemini — {"error":{"code","message","status","details"}}. Коды 401 и 402 требуют исправить состояние аккаунта; автоматически повторяйте только временные ошибки 429 и 5xx. Полный каталог с точным текстом — /docs/errors.
| Статус | Значение | Что делать |
|---|---|---|
400 | Некорректный запрос, unsupported_parameter или documented_limitation | Исправьте тело. Если error.code или error.details.error_code — documented_limitation или unsupported_parameter, уберите или перенесите названное поле: официальный API этого протокола его принимает, этот endpoint — нет. Не повторяйте неизменённый запрос. |
401 | API-ключ отсутствует, неверен или отозван | Передайте активный ключ sk-pool в x-api-key. Если ключ отозван, создайте новый; повторять запрос с тем же ключом не нужно. На нативной линии Gemini та же ошибка приходит как 400 INVALID_ARGUMENT с причиной `API_KEY_INVALID` в `error.details` — как в официальном Google API; обрабатывайте её так же, как 401. |
402 | Доступного предоплаченного баланса недостаточно | Пополните аккаунт, убедитесь, что баланс зачислен, и повторите запрос. Ожидание само по себе не устранит 402. Маршрут Messages: 402 billing_error. Маршруты OpenAI: 402 insufficient_quota (не 429 — SDK ретраят 429). Нативный Gemini: 402 FAILED_PRECONDITION. |
429 | Лимит запросов или временный дефицит мощности провайдера | Учитывайте Retry-After, если он есть; используйте ограниченную экспоненциальную задержку со случайным смещением. |
5xx | Временная ошибка шлюза или инфраструктуры провайдера | Повторите запрос с ограниченной экспоненциальной задержкой. Сохраните ID запроса и не допускайте бесконечных повторов. |
Кеширование промптов
GPT кеширует повторяющиеся префиксы промпта автоматически — ничего включать и размечать не нужно. Кешированный ввод любой модели тарифицируется по её ставке кешированного ввода из раздела «Модели и цены».
Дальше
Всё, на что ссылается эта страница, в одном месте.