API-референс

Каждый ответ несёт заголовок x-request-id, а генерирующие эндпоинты - стоимость запроса в usage.cost (USD). По этому id стоимость можно запросить и позже - см. Стоимость запроса.

Создать chat completion

Текстовые и мультимодальные ответы, с опциональным стримингом и вызовом инструментов.

curl https://api.altrouter.ai/v1/chat/completions \
  -H "Authorization: Bearer ar-..." \
  -H "Content-Type: application/json" \
  -d '{"model":"gpt-5.4","messages":[{"role":"user","content":"Hi"}]}'

Создать изображение

Генерация или редактирование изображения. Результат рехостится на наш CDN и возвращается ссылкой.

curl https://api.altrouter.ai/v1/images/generations \
  -H "Authorization: Bearer ar-..." \
  -H "Content-Type: application/json" \
  -d '{"model":"nano-banana-pro","prompt":"a red fox"}'

Создать видео

Асинхронно: запрос возвращается сразу со статусом queued, готовность опрашивается через GET /v1/videos/{id}. Резерв ставится при создании, списание - только за удавшийся рендер.

curl https://api.altrouter.ai/v1/videos \
  -H "Authorization: Bearer ar-..." \
  -H "Content-Type: application/json" \
  -d '{"model":"veo-3.1-fast","prompt":"a drone shot over a coastline","seconds":8}'

curl https://api.altrouter.ai/v1/videos/vid_... -H "Authorization: Bearer ar-..."

Опрос - GET /v1/videos/{id}, список последних рендеров - GET /v1/videos, редирект на готовый файл - GET /v1/videos/{id}/content.

Список моделей

Каталог вызываемых моделей с ценами (USD) и параметрами каждой модели. Параметров запроса нет.

Объект списка: { object: "list", data: Model[] }. Поля Model:

curl https://api.altrouter.ai/v1/models -H "Authorization: Bearer ar-..."

Баланс кредитов

Остаток на балансе аккаунта, которому принадлежит ключ. Параметров запроса нет.

curl https://api.altrouter.ai/v1/credits -H "Authorization: Bearer ar-..."

Стоимость запроса

Сколько списано за конкретный запрос. Параметр id - заголовок x-request-id из ответа (для видео подходит и его vid_…). Видны запросы аккаунта, которому принадлежит ключ. Стрим записывается в момент после [DONE] - если запросить сразу, можно получить 404 на долю секунды.

curl "https://api.altrouter.ai/v1/generation?id=req_mupm4nfkhzua0y8j" \
  -H "Authorization: Bearer ar-..."

Журнал списаний

Запросы аккаунта от новых к старым, у каждого cost_usd - тот же журнал, что в разделе «Логи» кабинета. Параметры: limit (1-100, по умолчанию 50) и cursor - значение next_cursor с прошлой страницы.

curl "https://api.altrouter.ai/v1/usage?limit=50" -H "Authorization: Bearer ar-..."

Пополнение баланса

Пополнять баланс можно без кабинета - например, из своего биллинга или бота. Подходит любой ключ аккаунта. Схема: создать счёт, отдать invoice_url плательщику, опрашивать платёж до status: finished. Кредиты зачисляются на аккаунт ключа автоматически, как при оплате из кабинета.

Создаёт счёт и возвращает ссылку на оплату. Ответ - 201.

Для полной автоматизации передайте pay_currency: ответ сразу содержит адрес и сумму, ваш сервер отправляет USDT со своего кошелька, баланс пополняется после подтверждения в сети. Открывать страницу оплаты не нужно.

curl https://api.altrouter.ai/v1/billing/checkout \
  -H "Authorization: Bearer ar-..." \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: order-1042" \
  -d '{"amount_usd": 50, "method": "crypto_platega"}'

curl https://api.altrouter.ai/v1/billing/checkout \
  -H "Authorization: Bearer ar-..." \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: topup-2026-11-08-01" \
  -d '{"amount_usd": 50, "pay_currency": "usdtbsc"}'

Один платёж с текущим статусом. Опрашивайте раз в 10-30 секунд, пока статус не станет finished, expired, failed или refunded. Крипта обычно подтверждается за несколько минут, СБП - почти сразу.

curl https://api.altrouter.ai/v1/billing/payments/5c47e990-b3e2-454d-b307-671d89e4246a \
  -H "Authorization: Bearer ar-..."

Платежи аккаунта от новых к старым. Параметры: limit (1-100, по умолчанию 20) и cursor - значение next_cursor с прошлой страницы.

curl "https://api.altrouter.ai/v1/billing/payments?limit=20" -H "Authorization: Bearer ar-..."

Без ключа: пакеты, доступные способы оплаты и цены в рублях для СБП. Для своей суммы - GET /v1/billing/quote?amount_usd=12.34.