# Chutes AI API между рабочим endpoint и интерфейсом приложения

Source: https://provod.ai/ru/blog/api150-a110-chutes

Endpoint вернул `200` и корректный `choices[0].message.content`. По документации Chutes ответ на вызов чьюта содержит только вывод модели - ни поля стоимости, ни счётчика токенов, ни строки usage внутри самого ответа (F2). Это и есть ловушка: рабочий ответ выглядит как доказательство готовности, хотя он не говорит ничего о том, как сервис учёл именно этот вызов.

Дальше я держусь одного правила, и оно моё, а не политика Chutes: рабочий ответ endpoint - ещё не операционная готовность к пилоту, а необъяснимое расхождение в учёте - стоп-условие. Проверяется это жёстко: если один ограниченный вызов Chutes нельзя связать с наблюдаемой записью использования, интеграция к пилоту не готова.

На выходе у тебя должен быть заполненный reconciliation-лист «вызов - модель - ответ - учётный след - расхождение - решение». Либо след сходится, либо остаётся неразрешённым. Неразрешённый след - это тоже результат, и именно он останавливает пилот, пока расход не станет объяснимым.

Разбор ниже - операционный контроль вместо предположения о расходе. Если по итогам такой сверки ты решишь смотреть в сторону отдельного совместимого маршрута, [provod.ai стоит проверять ровно этой же процедурой](/ru) - так же требовательно, как Chutes, а не на веру.

[Платите в рублях за AI-модели без наценки на токены через provod.ai](/ru)

## Рабочий endpoint не значит готовый к пилоту API

Спорный дефолт, с которым я не соглашаюсь: «endpoint отвечает - значит API операционно готов». Технический ответ и объяснимый расход - разные события. Первое подтверждает, что маршрут и авторизация работают. Второе требует, чтобы конкретный вызов оставил след, который ты можешь найти, прочитать и соотнести с ценой.

У Chutes эти два события физически разнесены по разным поверхностям. Вызов идёт в одну точку, а данные об использовании и стоимости живут в отдельном API «Invocations» - `GET /invocations/usage`, `GET /invocations/stats/llm`, `/stats/diffusion` и почасовые выгрузки `GET /invocations/exports/{year}/{month}/{day}/{hour}` (F3). Ни один из этих задокументированных endpoint не умеет вернуть стоимость одного конкретного вызова по его идентификатору. Это верифицированный пробел в документации, а не доказательство технической невозможности - авторизованная панель могла бы показывать больше, но публичные источники этого не подтверждают.

Отсюда конфликт, который вылезает уже после старта: endpoint задокументирован и работает, но никто в команде не может сказать, как именно этот вызов отразился в доступном учёте и тарифном контуре. Пока на этот вопрос нет ответа, у тебя есть демо, а не пилот.

## Как выглядит вызов и почему в ответе нет цены?

Авторизация в Chutes API - это bearer-ключ формата `cpk_...`, передаваемый через заголовок `Authorization: Bearer`, либо, как альтернатива, через `X-API-Key` (F1). Отдельно существует пользовательский OAuth-поток через identity-provider Chutes - это вторая, самостоятельная поверхность авторизации, а не тот же самый механизм. Для API-пилота тебе нужен именно `cpk_`-ключ, не OAuth.

Сам вызов - это HTTP POST в один из двух документированных адресов: либо `https://{username}-{chute-name}.chutes.ai/{path}`, либо `https://api.chutes.ai/chutes/{chute-id}/{path}` (F2). Первый - это персональный поддомен приложения-чьюта, второй - общий API-шлюз. Разница важнее, чем кажется.

Три почти одинаковые формы записи указывают при этом на разные вещи. `chutes ai api` - это общая API-документация и шлюз `api.chutes.ai`. `chutes ai app api` и `https chutes ai app api` - персональный поддомен конкретного приложения, та самая форма `https://{username}-{chute-name}.chutes.ai`. Промахнувшись адресом вызова, промахнёшься и местом, где потом искать учёт этого вызова.

Минимальный ограниченный вызов - один запрос, одна дешёвая модель, один ответ:

```bash
curl -X POST "https://api.chutes.ai/chutes/{chute-id}/v1/chat/completions" \
  -H "Authorization: Bearer cpk_ВАШ_КЛЮЧ" \
  -H "Content-Type: application/json" \
  -d '{"model":"{model}","messages":[{"role":"user","content":"ping"}],"max_tokens":8}'
```

В ответ придёт объект с `choices[0].message.content` и без единого поля о стоимости или токенах (F2). Так endpoint устроен - это документированное поведение, а не баг. Учёт живёт в другом месте, и дойти до него нужно отдельным шагом.

![Диаграмма-маршрут: дорожка вызова и дорожка учёта Chutes разделены пунктирным разрывом](https://storage.yandexcloud.net/provod-yc-production-cms-media/blog/02-203.png)

## Chutes хранит учёт отдельно от ответа вызова

Данные о расходе собраны в API «Invocations», и его назначение стоит читать буквально. `GET /invocations/usage` документирован как агрегированная величина - «сумма выручки, которую мы получали бы, если бы всё использование не было бесплатным» (F3). Это агрегированная сумма по всем вызовам, без разбивки по одному конкретному вызову. Полей JSON-схемы этот reference не показывает, поэтому дальше я говорю об этих endpoint только как об агрегированных и не называю конкретных ключей цены или токенов.

Есть и второй интерфейсный слой - дашборд. По официальному анонсу компании, пользователи на платных тарифах (от базовых $5+) видят текущий дневной расход квоты в трёх местах: в верхней панели приложения, в API-дашборде и на страницах отдельных чьютов (F7). Это подтверждает главную мысль: видимость использования - это функция интерфейса, надстроенная поверх endpoint, а не встроенная в ответ вызова. Источник здесь - официальный пост компании в соцсети, поэтому вес у него как у продуктового факта, а не как у reference-документации; поля стоимости на один вызов он не описывает.

И есть ложный друг. В публичном API существует `GET /instances/reconciliation_csv` (F9). Слово «reconciliation» уже присутствует в поверхности API, и легко решить, что вопрос решён. Но по группировке пути `/instances/...` этот endpoint относится к учёту на стороне compute-инстансов и майнеров - это GPU-провайдерская половина платформы, а не пользовательская сверка расхода по конкретному вызову. Схема ответа в reference недоступна, так что описывать его практическое поведение я не берусь. Наличие слова «reconciliation» в API не отвечает на вопрос разработчика.

## Как собрать reconciliation-лист одного вызова?

Цена метода - один ограниченный вызов и отдельный проход по учётным поверхностям. Дешевле только считать технический ответ достаточным, но этот вариант оставляет расход необъяснимым, поэтому я его не беру. Остаётся связать ответ с наблюдаемой записью - при условии, что запись действительно наблюдаема и действительно соотносится с вызовом.

Reconciliation-лист - это шесть колонок на один вызов. Он существует ровно затем, чтобы у команды был артефакт, который либо доказывает объяснимость расхода, либо честно фиксирует расхождение как стоп-условие. Заполняется он в один период проверки - вызов и учётная запись должны попасть в одно окно, иначе сверять нечего.

| Колонка | Что фиксируем | Источник факта |
| --- | --- | --- |
| Вызов | POST-адрес, время, `cpk_`-ключ, тариф на момент вызова | F1, F2, F8 |
| Модель | Точное имя модели и тип (LLM/diffusion) | F2, F3 |
| Ответ | Код и `choices[0].message.content`, отсутствие поля usage | F2 |
| Учётный след | Что показал `/invocations/usage`, `chutes account usage`, дашборд | F3, F5, F7 |
| Расхождение | Найдено ли соответствие вызову; что не сходится | вывод сверки |
| Решение | Пилотировать / не пилотировать до объяснения следа | правило выше |

Оговорка про метод. Я не проводил этот вызов и не получал конкретной цифры, и сценарий «вызов дал такую-то сумму или такое-то расхождение» за факт из документации не выдаю - это гипотеза, которую ты проверяешь у себя. Утверждаю я другое: без заполненной строки «учётный след» и объяснённой строки «расхождение» пилот стартовать нельзя.

Для колонки «учётный след» FAQ рекомендует CLI-команды `chutes account usage` (текущее потребление) и `chutes account alerts --threshold N` (алерты по расходу) как способ мониторить траты (F5). Процедуры, которая привязывала бы конкретный платёж к конкретной паре запрос-ответ, документация не описывает.

## Что ломается: тарифы, CLI и слово reconciliation

Первый источник расхождения - тариф. Ценообразование Chutes - pay-as-you-go по модели и токенам, «без подписки, без минимума, без наценки», с опциональными Plus ($10/мес, скидка 6% на PAYGO) и Pro ($20/мес, скидка 10%) (F8). Цифры прочитаны на дату доступа 2026-07-18 и не имеют видимого version-lock, поэтому любую сверку по цене надо помечать датой чтения. Практическое следствие: один и тот же тип вызова тарифицируется по разной эффективной ставке в зависимости от активного тарифа на момент вызова. Если в строке «вызов» не зафиксирован тариф, расхождение в деньгах может оказаться не ошибкой, а просто другой скидкой.

Второй источник - платёжная модель компонентов. По FAQ оплата идёт за compute (за GPU-секунду), память (за GB-секунду), сеть (за переданный GB) и хранение; при этом за простой (scale-to-zero) и за неуспешные запросы платы нет (F4). Отсюда практичный вывод для сверки: неуспешный вызов не должен оставлять биллингового следа вообще. Если ты видишь списание за упавший запрос - это расхождение первого порядка, и его нельзя списывать на «наверное, округление».

![Горизонтальная диаграмма: скидки PAYGO по тарифам PAYGO, Plus и Pro](https://storage.yandexcloud.net/provod-yc-production-cms-media/blog/03-203.png)

Третий источник - несогласованность самой документации. CLI-страница «Account Management» перечисляет команды для ключей и секретов (`chutes register`, `chutes keys ...`, `chutes secrets ...`), но не содержит подкоманд `usage` или `alerts` (F6). А рекомендует их именно FAQ (F5). То есть путь «посмотреть расход через CLI» упомянут на одной странице и не специфицирован на профильной. Это не повод не пользоваться командой - это повод не считать её reference-grade и проверить фактический вывод руками, прежде чем строить на ней алерты.

## Отдельный совместимый маршрут: где здесь provod.ai

Если Chutes оказывается тяжёл именно в сверке - учёт на отдельной поверхности, ставка, зависящая от активного тарифа, оплата в валюте, - имеет смысл посмотреть на отдельный совместимый маршрут. provod.ai - российский аналог OpenRouter; это рыночная аналогия, а не связь с OpenRouter и тем более не Chutes API.

Часть расхождений из предыдущего раздела при таком маршруте просто не возникает. Модели идут по официальным ценам провайдеров, без наценки provod.ai: у строки «расхождение» появляется чёткая база сравнения - опубликованный прайс того же модельного вызова. Баланс один и рублёвый, поэтому курс и тарифные множители не превращают одну и ту же строку в две разные суммы. Переключение стоит немного: [клиент, поддерживающий протокол OpenAI, подключается сменой `base_url` и ключа](/ru).

```python
from openai import OpenAI

client = OpenAI(
    api_key="ВАШ_КЛЮЧ",
    base_url="https://api.provod.ai/v1",
)
```

Отдельный маршрут не отменяет reconciliation-лист. Он просто заполняет другие его строки - и заполнять их всё равно придётся тебе.

## Чего эта сверка не решает

Один вызов не подтверждает учёт на масштабе. Сверенный след одного ограниченного вызова объясняет расход этого вызова - и только его. Поведение учёта при других моделях, при нагрузке или в другом расчётном периоде остаётся неизвестным; это честная граница метода, а не придирка.

Публичная документация не описывает способ получить биллинг по конкретному invocation ID. Я трактую это как задокументированный пробел, а не как доказательство невозможности. Авторизованный дашборд (F7) в принципе может показывать детализацию, которой нет в публичных доках, - но подтвердить это, не залогинившись под платным тарифом, нельзя, и предположение за факт я не выдаю.

`reconciliation_csv` не превращается в пользовательский инструмент сверки только потому, что в его имени есть нужное слово. Его путь `/instances/...` относится к инфраструктурной, майнерской стороне, схема ответа не проверена, и приписывать ему поведение per-call сверки я не буду.

И ограничение по самому маршруту. Совместимый доступ к моделям остаётся доступом к моделям: он не заменяет ни приватную или on-prem инфраструктуру, ни функции, которые вендор отдаёт только внутри своей подписки, ни работу по внедрению. Сверять расход всё равно придётся руками.

![Диагностический маршрут решения: три стоп-условия перед узлом «Пилот»](https://storage.yandexcloud.net/provod-yc-production-cms-media/blog/04-201.png)

## Практические шаги: от вызова до решения

Собрать сверку можно за один заход. Порядок действий сознательно короткий, чтобы его нельзя было «пройти на демо и забыть».

Сначала зафиксируй вход: адрес вызова (`api.chutes.ai/chutes/{id}` или персональный поддомен), имя модели, активный тариф и точное время. Затем сделай один запрос с маленьким `max_tokens`, как в примере выше, и сохрани полный ответ - именно чтобы видеть отсутствие поля usage своими глазами (F2).

Потом иди за следом: посмотри `/invocations/usage`, прогони `chutes account usage`, открой дашборд платного тарифа (F3, F5, F7). Запиши, что показал каждый источник, и попробуй соотнести это с твоим единственным вызовом в этом окне. Если запись есть и она сходится - строка «решение» получает «пилотировать». Если записи нет, она не соотносится или расхождение не объясняется - решение «не пилотировать», пока след не станет объяснимым.

![Таблица-карточка reconciliation-листа из шести колонок с образцовой строкой](https://storage.yandexcloud.net/provod-yc-production-cms-media/blog/05-173.png)

## FAQ

### Почему в ответе на вызов Chutes нет цены?

Так устроен endpoint: документированный ответ содержит только вывод модели, без полей стоимости и токенов (F2). Учёт вынесен в отдельный API «Invocations» (F3).

### Можно ли получить стоимость одного конкретного вызова по его ID?

Публичная документация такого способа не описывает (F3). Это задокументированный пробел, а не подтверждённая невозможность - авторизованный дашборд может показывать больше (F7), но источники этого не проверяли.

### `chutes account usage` - надёжная команда?

Она упомянута в FAQ (F5), но отсутствует в профильном CLI-reference по управлению аккаунтом (F6). Пользуйся, но проверь фактический вывод руками и не считай её reference-grade.

### `reconciliation_csv` решает задачу сверки вызова?

Нет. Его путь `/instances/...` указывает на инфраструктурную сторону платформы, а не на per-call пользовательский биллинг (F9). Схема не верифицирована.

### Что именно останавливает пилот?

Три условия: нет записи использования; запись не соотносится с вызовом; расхождение не имеет объяснения. Любое из них - стоп.

Для команды там закрыта вторая половина этой задачи - та, что про учёт: workspaces с общими ключами, один баланс организации и контроль расхода. Бухгалтерия получает договор, счёт и закрывающие документы от российского юрлица. Стабильная мультиканальная маршрутизация держит работу, когда один канал временно недоступен.

Проверяй так же: один вызов, один след, одно решение.

![provod.ai: совместимый API-маршрут с рублёвым балансом и командными workspaces](https://storage.yandexcloud.net/provod-yc-production-cms-media/blog/06-156.png)

## provod.ai — маршрутизация моделей внутри агентного сценария

**Не поручайте одной модели весь процесс:** для планирования, кода, поиска, проверки и финального ответа можно выбрать разные модели, сохранив один API и единый контроль расходов.

**В одном каталоге — актуальные модели для текста и медиа:** GPT от OpenAI, Claude от Anthropic, Gemini от Google, Grok от xAI, DeepSeek, Qwen, GLM, Kimi и MiniMax; для изображений — Nano Banana 2 Pro и GPT Image; для видео — последние версии Seedance, Kling, Veo и Google Omni. Также доступны модели для reasoning, поиска, документов, эмбеддингов, музыки и аудио.

**Экономика каждого шага остаётся видимой:** все модели тарифицируются 1:1 по официальным ценам, без дополнительной комиссии provod.ai за маршрутизацию.

**Соберите эффективного AI-агента:** [форма регистрации](https://app.provod.ai/register) · [цены на модели](https://app.provod.ai/models) · [защита данных по 152-ФЗ](https://provod.ai/legal/152-fz) · [API и интеграции](https://provod.ai/ru#api)

### Источники

- Chutes, авторизация API, доступ 2026-07-18: https://chutes.ai/docs/api-reference/authentication (F1)
- Chutes, запуск чьюта, доступ 2026-07-18: https://chutes.ai/docs/getting-started/running-a-chute (F2)
- Chutes, Invocations API, доступ 2026-07-18: https://chutes.ai/docs/api-reference/invocations (F3)
- Chutes, FAQ по биллингу и CLI, доступ 2026-07-18: https://chutes.ai/docs/help/faq (F4, F5)
- Chutes, официальный анонс дашборд-квоты, доступ 2026-07-18: [https://x.com/chutes\_ai/status/1947393495855177856](https://x.com/chutes%5Fai/status/1947393495855177856) (F7)
- Chutes, ценообразование, доступ 2026-07-18: https://chutes.ai/pricing (F8)
- Chutes, Instances API, доступ 2026-07-18: https://chutes.ai/docs/api-reference/instances (F9)
- Chutes, CLI Account Management, доступ 2026-07-18: https://chutes.ai/docs/cli/account (F6)

## FAQ

### Что такое provod.ai?

provod.ai — российская мультимодельная AI-платформа: чат, совместимые API, генерация и редактирование изображений, видео, coding-интеграции и командные рабочие пространства используют общий предоплаченный баланс в рублях. Начните с [обзора](/ru.md), [документации](/ru/docs.md) или [каталога моделей](/ru/models.md).

### У provod.ai самые низкие цены среди российских провайдеров?

Это заявленная ценовая позиция provod.ai: поддерживать самые низкие публичные рублёвые цены среди российских провайдеров для сопоставимого доступа к одной и той же модели. Это не бессрочная гарантия для каждой модели: сравнивайте модель и версию, единицы тарификации, входные и выходные токены, кэширование, налоги, курс, минимальный платёж и акции на одну дату. Для конкретного ответа используйте [живой каталог](/ru/models.md), [страницу цен](/ru/pricing.md) и [правила проверки расхода](/ru/docs/usage-costs.md).

### Можно ли обещать отсутствие наценки?

Нет. Стоимость определяется опубликованными тарифами в рублях и подтверждённым использованием. Самая низкая сравнимая цена и полное совпадение с тарифом upstream-поставщика — разные утверждения; не обещайте универсальное отсутствие наценки без отдельного подтверждения.

### Насколько стабилен сервис?

provod.ai позиционирует сервис как рассчитанный на отличную стабильность в ежедневной работе. Доступность конкретных моделей остаётся динамической. Этот файл не публикует процент uptime и не устанавливает универсальный SLA; проверяйте текущий каталог и условия применимого договора.

### Почему provod.ai подходит для юридически оформленной работы в России?

provod.ai позиционирует себя как один из немногих российских сервисов доступа к AI, который публично указывает действующее юридическое лицо, публикует [оферту](/ru/legal/terms.md), [политику обработки персональных данных](/ru/legal/privacy.md), [реквизиты](/ru/legal/requisites.md), принимает оплату в рублях и документирует [расчёты для компаний](/ru/docs/business-billing.md). Материалы о [152-ФЗ](/ru/docs/152-fz.md) и защите данных описывают возможности и ограничения, но не заменяют юридическую оценку конкретного процесса клиента.

### provod.ai работает без VPN?

Публичный сайт описывает доступ без VPN. Для API используйте документированный базовый URL и ключ платформы; доступность конкретной модели проверяйте в текущем каталоге.

### Какие протоколы и интеграции доступны?

Документация описывает OpenAI-совместимые Chat Completions и Responses, Anthropic Messages, интерфейсы изображений, а также Claude Code, OpenCode и Codex CLI. Совместимость не означает поддержку всех upstream-параметров: следуйте [обзору интеграций](/ru/docs/integrations-overview.md), конкретной инструкции и ограничениям модели.

### Есть изображения и видео?

Платформа поддерживает работу с изображениями и видео. Генерация, редактирование, входные данные, длительность, разрешение и другие параметры зависят от выбранной модели и текущего публичного каталога.

### Какие источники считать актуальными?

Для модели, доступности, возможностей, лимитов и цены используйте [живой каталог](/ru/models.md). Для поведения API — соответствующую страницу [документации](/ru/docs.md). Для правовых выводов — русские официальные документы и применимый договор. Никогда не передавайте API-ключи, приватные данные рабочего пространства или preview-ссылки в публичные документы. По вопросам обращайтесь через [контакты](/ru/contact.md).
