apiToken.saleДокументация

Подключение моделей

Один API‑ключ, один endpoint, все модели GPT и Gemini — нативные протоколы OpenAI и Gemini, маршрут Anthropic Messages для Claude Code и OpenAI‑совместимый API для любого клиента. AI‑агент сам настроит и проверит подключение.

Для вашего AI‑агента

Прочитай https://apitoken.sale/md/connect и следуй инструкциям, чтобы подключить этот проект к apiToken.sale.

Помощь с подключением

IDE, SDK, endpoint, модели и ошибки запросов.

TelegramОператоры · 08:00–12:00 UTC
02

Быстрый старт

Подключите apiToken.sale к coding agent, который читает, изменяет и запускает ваш проект. Выберите стек — точная инструкция появится ниже.

Интеграции

Подключите coding agent

Выберите провайдера, coding agent и операционную систему — инструкция обновится сразу.

Провайдер
Операционная система
Coding agent

Codex · GPT-6.1 Terra

Codex CLI с apiToken.sale как провайдером Responses API по умолчанию.

  • GPT
  • Codex
  • macOS / Linux · zsh · bash
  • GPT-6.1 Terra
Endpointhttps://router.apitoken.sale/v1
  1. Запустите установку одной командой

    Стрелки перемещают курсор, пробел отмечает провайдеров, Enter запускает установку. Первый отмеченный провайдер задаёт модель по умолчанию. Скрипт устанавливает или обновляет клиент до последней стабильной версии. Установка создаст ~/.codex/config.toml, сохранит резервную копию и импортирует модели всех выбранных провайдеров. Обычная команда codex тоже по умолчанию работает через apiToken.sale.

    ~/.codex/config.toml
    curl -fsSL https://apitoken.sale/setup/connect.sh | bash
  2. Запустите Codex

    После установки откройте новый терминал. Обычная команда запускается с вашими настройками apiToken.sale. Для выбора GPT-6.1 Terra запустите codex --model openai/gpt-6.1-terra.

    Терминал
    codex
  3. Проверьте маршрут

    Отправьте один однозначный запрос. Ответ подтвердит профиль, ключ, endpoint, модель и streaming.

    В Codex
    Reply with exactly: connected
03

Один endpoint, все протоколы

router.apitoken.sale — единая точка входа для GPT и Gemini. Coding‑агенты и официальные SDK получают нативные API байт‑в‑байт; Claude Code работает с моделями GPT и Gemini через маршрут Anthropic Messages; любой OpenAI‑совместимый клиент работает со всеми текстовыми моделями каталога через один универсальный маршрут. Тот же ключ sk‑pool и тот же предоплаченный баланс.

Base URLhttps://router.apitoken.sale

Нативные API

Протоколы провайдеров байт‑в‑байт — для coding‑агентов и официальных SDK, которым нужна полная точность: reasoning, tool use, кеширование промптов. Маршрут Messages отдаёт модели GPT и Gemini для Claude Code и других клиентов Anthropic Messages.

  • POST/v1/messagesMessages
  • POST/v1/responsesOpenAI
  • POST/v1beta/models/{model}:generateContentGemini

OpenAI-совместимый

Один универсальный маршрут для всех текстовых моделей каталога — GPT и Gemini — из любого OpenAI‑совместимого клиента или SDK. Неподдерживаемые параметры fail-closed с понятным 400.

  • POST/v1/chat/completionsЛюбая текстовая модель каталога

Единый каталог

Все доступные модели с namespaced ID — openai/*, google/*. Обычные нативные ID продолжают работать, пока они однозначны.

  • GET/v1/modelsЛюбая модель каталога

Уже подключены? Per-provider endpoint'ы openai.api.apitoken.sale/v1 и gemini.api.apitoken.sale полностью поддерживаются с тем же ключом и балансом — единый router рекомендован для новых интеграций.

Лимиты вывода GPT: корректные max_output_tokens, max_tokens и max_completion_tokens принимаются и игнорируются. Они не ограничивают генерацию и не обрезают ответ. stop и stop_sequences по-прежнему применяются к выдаваемому тексту. Usage и биллинг учитывают полную фактическую генерацию. Gemini Chat и Responses также игнорируют parallel_tool_calls, включая false: этот параметр не заставляет модель вызывать инструменты последовательно.

GPT · Native API · cURL

OpenAI Responses API на едином endpoint — нативный wire format с тем же ключом sk-pool в Authorization: Bearer.

  • GPT
  • Authorization: Bearer
Endpointhttps://router.apitoken.sale/v1
  1. Сохраните ключ в окружении

    Держите ключ на сервере: переменная окружения или менеджер секретов, не браузерный bundle. В Windows PowerShell используйте $env:APITOKEN_API_KEY.

    Терминал
    export APITOKEN_API_KEY="sk-pool-•••"
  2. Отправьте первый запрос

    Все доступные текстовые модели GPT отвечают на этом маршруте. Актуальный список получайте через GET /v1/models на том же endpoint, а не зашивайте ID в код.

    HTTP
    curl https://router.apitoken.sale/v1/responses \  -H "Authorization: Bearer $APITOKEN_API_KEY" \  -H "Content-Type: application/json" \  -d {    "model": "gpt-6.1-terra",    "input": "Reply with exactly: connected"  }
  3. Сгенерируйте изображение через GPT Image 2.6

    Используйте gpt-image-2.6-sunburst или gpt-image-2.6-flare с POST https://router.apitoken.sale/v1/images/generations. Обе модели поддерживают статические PNG, JPEG и WebP, n=1..10. size задаёт пропорции, а не точное число пикселей или 4K; фактические размер и качество указаны в ответе. Высокое значение quality не гарантирует более высокий уровень результата. GIF, SVG, complexity, markup, анимация и стриминг возвращают 400 documented_limitation. GPT Image 2, 2.5 и 2.6 поддерживают POST /v1/images/edits с 1–16 референсами PNG, JPEG или WebP (каждый ≤50 MiB, всего ≤250 MiB) — файлами multipart image/image[] или JSON images: [{"image_url": "https://…" | "data:image/png;base64,…"}]. Ссылки file_id и поле mask не поддерживаются. Hosted-инструменты Responses для GPT Image 2.6 здесь недоступны.

    HTTP
    curl https://router.apitoken.sale/v1/images/generations \  -H "Authorization: Bearer $APITOKEN_API_KEY" \  -H "Content-Type: application/json" \  -d {    "model": "gpt-image-2.6-sunburst",    "prompt": "A watercolor lighthouse at dawn"  }
  4. Закрасьте область по PNG-маске

    Multipart-поле mask на POST /v1/images/edits игнорируется. Inpaint — вызов Responses: отправьте текстовую GPT-модель (например gpt-5.6-sol) на POST https://router.apitoken.sale/v1/responses, исходный PNG в input как input_image, и tools: [{type:"image_generation", input_image_mask:{image_url}, …}]. Опциональные Responses-controls: output_format jpeg/webp, partial_images 1..=3 (SSE response.image_generation_call.partial_image); background=transparent переписывается в opaque, input_fidelity отбрасывается. Chat Completions мапит тот же hosted image_generation на Responses. Оба URL — data:image/png;base64,…. Маска того же размера, что исходник; прозрачные пиксели — зона правки. file_id не поддерживается (нет Files API). Биллинг по image-токенам; маска не вторая reference-картинка. POST /v1/images/* тоже может отдать jpeg/webp локальным транскодом нативного PNG.

    HTTP
    curl https://router.apitoken.sale/v1/responses \  -H "Authorization: Bearer $APITOKEN_API_KEY" \  -H "Content-Type: application/json" \  -d {    "model": "gpt-5.6-sol",    "input": [{      "role": "user",      "content": [        {"type": "input_text", "text": "Change only the masked region."},        {"type": "input_image", "image_url": "data:image/png;base64,SOURCE_PNG"}      ]    }],    "tools": [{      "type": "image_generation",      "output_format": "webp",      "partial_images": 2,      "input_image_mask": {"image_url": "data:image/png;base64,MASK_PNG"}    }]  }
  5. Считайте баланс и расход

    Тот же ключ читает свой аккаунт: GET https://router.apitoken.sale/usage возвращает живой баланс и расход за любое окно — from и to в RFC3339 UTC (to не включается), group_by — одно из model, provider, day, day,provider, day,model, api_key. По умолчанию — последние 30 дней в разрезе моделей. Один отчёт покрывает всех провайдеров каталога. cost — что списано с вас, list_cost — прайс провайдера за тот же трафик; оба дублируются точной целой строкой *_nano — читайте деньги как строку, не как float. Окно не длиннее 366 дней. GET https://router.apitoken.sale/balance отдаёт только баланс.

    HTTP
    curl -sG "https://router.apitoken.sale/usage" \  -H "x-api-key: $APITOKEN_API_KEY" \  --data-urlencode "from=2026-08-01T00:00:00Z" \  --data-urlencode "to=2026-09-01T00:00:00Z" \  --data-urlencode "group_by=model"
Один ключ sk-pool работает на всех маршрутах единого endpoint. Не включайте его в клиентский код.Получить API‑ключ
04

API баланса и расхода

Тот же ключ, который тратит деньги, читает, на что они ушли. Один маршрут отдаёт живой баланс и точный расход за любое окно по всем провайдерам — без личного кабинета и без второго ключа.

ПараметрЧто задаёт
fromНачало окна, включительно. RFC3339 UTC — 2026-08-01T00:00:00Z, явный числовой offset или голая дата 2026-08-01. По умолчанию — to минус 30 дней.
toКонец окна, **не включается**. Те же формы. По умолчанию — «сейчас»; будущее значение подрезается до «сейчас».
group_bymodel (по умолчанию), provider, day, day,provider, day,model или api_key. Порядок в списке не важен, а model,provider — просто псевдоним model: строка модели и так называет своего провайдера.

Один запрос

Передайте свой ключ sk-pool- в x-api-key (или как Authorization: Bearer). Маршрут обслуживают все точки входа.

HTTP · Request
curl -sG "https://router.apitoken.sale/usage" \  -H "x-api-key: $APITOKEN_API_KEY" \  --data-urlencode "from=2026-08-01T00:00:00Z" \  --data-urlencode "to=2026-09-01T00:00:00Z" \  --data-urlencode "group_by=model"

Ответ

В ответе эхом возвращается ровно то окно, по которому посчитан отчёт, затем живой баланс, итоги и по строке на группу.

JSON · Response
{  "account": "acct_…",  "from": "2026-08-01T00:00:00Z",  "to": "2026-09-01T00:00:00Z",  "group_by": "model",  "balance": {    "balance": "$12.345678",    "balance_nano": 12345678000,    "reserved_nano": 0,    "spent": "$3.210000",    "status": "active"  },  "totals": {    "requests": 1804,    "cost": "$3.210000",    "cost_nano": "3210000000",    "list_cost": "$6.420000",    "input_tokens": 9000000,    "output_tokens": 250000,    "cache_read_tokens": 4100000  },  "data": [    {      "provider": "openai",      "model": "gpt-6.1-terra",      "requests": 1200,      "cost": "$2.100000",      "cost_nano": "2100000000",      "list_cost": "$4.200000",      "input_tokens": 7000000,      "output_tokens": 180000    }  ]}

Две цены, обе точные. cost — что списано с вас; list_cost — прайс провайдера за тот же трафик, разница и есть ваша скидка. Обе дублируются целой строкой *_nano. Читайте деньги как строку, никогда как float.

Только явный UTC. Локальное время без offset отклоняется: догадка о зоне молча сдвинула бы границы денежного отчёта. Окно должно быть положительным и не длиннее 366 дней, иначе придёт 400 в конверте ошибок протокола хоста (Messages, OpenAI или Gemini этого хоста), с причиной в error.message.

Разрезы сходятся. Любой разрез одного окна даёт тот же итог: все они читаются из одного согласованного снимка. Токены есть в разрезах model, provider и day,model; простые дневные разрезы несут деньги и число запросов. Разрез day,model — расход по каждой модели по дням — ограничен 92 днями и за этой границей отвечает 400, а не молча теряет строки. Ключи маскируются. GET /balance отдаёт только баланс.

05

Модели и цены

GPT и Gemini, все доступные модели и точные ставки за 1M токенов — официальная цена против той, что платите вы с единой скидкой 50%.

GPT · OpenAI Responses API

router.apitoken.salePOST /v1/responses · POST /v1/chat/completions
Authorization: Bearer
МодельКонтекстМакс. выводВводКеш. вводЗапись в кешВывод
GPT-6.1 TerraНоваяgpt-6.1-terra872K128K$0.5$1$0.025$0.05$0.625$1.25$2.5$5
GPT-6.1 Solgpt-6.1-sol872K128K$1$2$0.05$0.1$1.25$2.5$5$10
GPT-6 Astragpt-6-astra872K128K$5$10$0.5$1$6.25$12.5$25$50
GPT-6 Solgpt-6-sol872K128K$1$2$0.1$0.2$1.25$2.5$5$10
GPT-6 Lunagpt-6-luna872K128K$0.05$0.1$0.005$0.01$0.0625$0.125$0.25$0.5
GPT-5.6 Solgpt-5.6-sol872K128K$2$4$0.2$0.4$2.5$5$10$20
GPT-5.6 Terragpt-5.6-terra872K128K$1$2$0.1$0.2$1.25$2.5$6$12
GPT-5.6 Lunagpt-5.6-luna872K128K$0.1$0.2$0.01$0.02$0.125$0.25$0.6$1.2
GPT Image 2gpt-image-2per request1–10 images (n)$2.5$5$0.625$1.25$0$0$15$30
GPT Image 2.5 Flaregpt-image-2.5-flareper request1–10 images (n)$2.5$5$0.625$1.25$0$0$15$30
GPT Image 2.5 Sunburstgpt-image-2.5-sunburstper request1–10 images (n)$2.5$5$0.625$1.25$0$0$15$30
GPT Image 2.6 Flaregpt-image-2.6-flareper request1–10 images (n)$2.5$5$0.625$1.25$0$0$15$30
GPT Image 2.6 Sunburstgpt-image-2.6-sunburstper request1–10 images (n)$2.5$5$0.625$1.25$0$0$15$30
GPT-6.1 Terra — новейшая модель GPT, GPT-6 Astra — самая мощная; у моделей GPT-6 и GPT-5.6 максимум 872K контекста и 128K вывода. Кеширование автоматическое — повторяющиеся префиксы тарифицируются по ставке кешированного ввода, ничего включать не нужно. gpt-5.6 — алиас gpt-5.6-sol.

Gemini · Google Gemini API

router.apitoken.salePOST /v1beta/models/{model}:generateContent
x-goog-api-key
МодельКонтекстМакс. выводВводКеш. вводЗапись в кешВывод
Gemini 4 HydrogenНоваяgemini-4-hydrogen1M shared by input, thinking and output64K streaming · 32K non-streaming$0.75$1.5$0.0375$0.075—$3.75$7.5
Gemini 4 Carbongemini-4-carbon1M shared by input, thinking and output64K streaming · 32K non-streaming$1$2$0.05$0.1—$5$10
Gemini 4 Argongemini-4-argon1M shared by input, thinking and output64K streaming · 32K non-streaming$1$2$0.05$0.1—$5$10
Gemini 3.8 Flashgemini-3.8-flash1M64K$0.375$0.75$0.0375$0.075—$1.875$3.75
Кешированный ввод Gemini 4 (Hydrogen, Carbon и Argon) стоит 5% от ввода, Flash — 10%. У Gemini 4 до 64K вывода в стриме и 32K без стрима; серверные инструменты недоступны.
Пример · GPT-6.1 Terra2M input × $1 = $2400K output × $5 = $2Официально итого = $4
Вы платите$2
Пополнение на $100 даёт $200 официального использования API на любой модели — каждый доллар конвертируется по той же ставке.
  • Ставки указаны за 1M токенов; списание идёт за фактические токены по официальным ставкам, затем вычитается единая скидка 50%.
  • Токены размышлений (thinking/reasoning) тарифицируются как вывод у обоих провайдеров.
  • GPT-запросы свыше 272K входных токенов тарифицируются по официальным ставкам длинного контекста: 2× ввод и 1,5× вывод на весь запрос.
  • Ставки Gemini соответствуют официальному стандартному платному тарифу Google.
  • Актуальный список доступных моделей — всегда в GET /v1/models на едином endpoint: один агрегированный каталог для всех провайдеров.
06

Как отправлять файлы в 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.

Запрос с файлом

Загрузка и ссылка на файл заменяются одним запросом. Base64 добавляет примерно треть объёма, поэтому в наш лимит тела 32 МБ укладывается исходный файл примерно до 23 МБ.

JSON · Request
{  "contents": [    {      "role": "user",      "parts": [        { "text": "Describe this file" },        { "inline_data": { "mime_type": "image/png", "data": "<base64>" } }      ]    }  ]}

Когда мы отказываем. Данные, которые шлюз принять не может, отклоняются до отправки провайдеру — 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 — назовите его поддержке, и мы найдём именно ваш запрос.

07

Основные коды ответа

На едином 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 — нет. Не повторяйте неизменённый запрос.
401API-ключ отсутствует, неверен или отозванПередайте активный ключ 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 запроса и не допускайте бесконечных повторов.

Полный каталог ошибок с точным текстом ответа →

08

Кеширование промптов

GPT кеширует повторяющиеся префиксы промпта автоматически — ничего включать и размечать не нужно. Кешированный ввод любой модели тарифицируется по её ставке кешированного ввода из раздела «Модели и цены».

GPT — автоматически

Ничего включать не нужно: повторяющиеся префиксы кешируются на стороне сервера. usage.prompt_tokens_details.cached_tokens (Chat Completions) или input_tokens_details.cached_tokens (Responses) автоматически тарифицируются как 10% от цены ввода (5% для GPT-6.1 Sol и Terra).

JSON · Response
{  "usage": {    "prompt_tokens": 5120,    "prompt_tokens_details": { "cached_tokens": 4096 },    "completion_tokens": 128  }}

Маршрут Messages — Claude Code

Claude Code помечает стабильные блоки cache_control: {"type": "ephemeral"}. Для моделей GPT и Gemini на /v1/messages этот маркер принимается и удаляется и не меняет кеширование. Любая другая форма cache_control, например с TTL, возвращает 400 с именем параметра.

JSON · Request
{  "model": "openai/gpt-6.1-terra",  "max_tokens": 1024,  "system": [    {      "type": "text",      "text": "Long stable instructions…",      "cache_control": { "type": "ephemeral" }    }  ],  "messages": [{ "role": "user", "content": "Short varying question" }]}
09

Дальше

Всё, на что ссылается эта страница, в одном месте.