Цены

Каждая модель стоит ровно столько, сколько её разработчик взимает за неё, в долларах США. Оплата списывается с вашего баланса API, который учитывается в API-кредитах: 1 000 API-кредитов = 1 $. Баланс API — это отдельный баланс, не связанный с кредитами приложений Doitong. Нет тарифных планов, минимальных сумм или комиссий за модель: вызов стоит указанную цену, которая списывается с баланса API после принятия запроса.

В России (doitong.ru, api.doitong.ru или ?currency=rub) цены также отображаются в рублях: цена в USD × курс USD/RUB × 1,3.

Единицы измерения#

У каждой модели есть одна расчётная единица, указанная на её странице и в GET https://api.doitong.com/v1/models/{model_id}:

Цена = количество × API-кредиты за единицу с округлением вверх до целого API-кредита (0,001 $), но не менее 1. Очень дешёвые единицы могут иметь дробную цену за единицу (0.4 API-кредита за секунду); округляется только общая стоимость вызова.

Некоторые модели используют разные тарифы в зависимости от входных данных: видео со звуком стоит дороже, чем без звука, 4K дороже, чем 1K, и так далее. Эти правила перечислены на странице каждой модели. Если параметр не указан, используется его значение по умолчанию, поэтому цена, которую вы видите для входных данных, — это цена, которую вы платите.

Точные, измеренные, оценочные цены и цены по использованию#

У каждой цены есть mode:

• exact: цена вычисляется на основе входных данных (секунды, изображения, мегапиксели, символы, шаги либо фиксированная цена за видео или вызов).
• measured: цена зависит от отправленных вами файлов: длительности входного видео или аудио, размера входного изображения, частоты кадров или количества кадров видео. По этому принципу рассчитывается стоимость апскейлинга, lip sync, преобразования видео, транскрибации и аудиоинструментов. Перед запуском API считывает длительность, разрешение и частоту кадров файла (расчёт делает то же самое), поэтому расчёт точно соответствует стоимости запуска. На странице модели указано, за что вы платите («Цена за секунду входного видео»), а калькулятор использует параметры вашего файла. Файл, который невозможно прочитать, отклоняется с ошибкой unmeasurable_input, и оплата не взимается.
• estimate: собственная стоимость модели зависит от того, что входные данные не позволяют заранее определить (токены, время вычислений). Такая модель взимает фиксированную оценочную цену за запуск (за выходное изображение, если указано количество изображений), рассчитанную на основе средней стоимости реальных запусков этой модели. Вы по-прежнему знаете цену до запуска: расчёт показывает сумму к оплате.
• metered: с модели взимается плата за фактическое использование, известное только самому запуску: токены, которые языковая или визуальная модель читает и записывает, секунды речи, генерируемой голосовой моделью, или время обработки моделью. См. раздел Оплата по использованию ниже.

На страницах моделей указаны «Цена за запуск», «Цена за секунду входного видео» и подобные формулировки, «Оценочная цена за запуск» или «Оплата по использованию»; GET https://api.doitong.com/v1/models?mode=measured, ?mode=estimate и ?mode=metered позволяют получить соответствующие модели.

Оплата по использованию#

У модели metered есть цена использования («$0.01 за 1000 токенов», «$0.002 за секунду сгенерированного аудио», «$0.00111 за секунду времени обработки») и максимальная стоимость за запуск: наибольшая сумма, которую может стоить запуск, исходя из данных вашего запроса (max_tokens, длина текста, разрешение, количество выходных данных) и опубликованных ограничений модели. Она никогда не зависит от содержимого файла по URL. Для модели, оплачиваемой по времени обработки или длительности голосовой сессии, максимум равен наибольшей допустимой длительности запроса (15 минут для изображений, 30 для аудио, 60 для видео), поэтому он значительно выше стоимости обычного запуска. Входные данные, для которых максимальная стоимость превышала бы лимит модели за запуск (например, очень длинный текст), отклоняются с ошибкой 422 invalid_input:

1. Расчёт возвращает этот максимум в поле credits (а также hold и typical — стоимость обычного запуска). При начале запуска максимум списывается с баланса API; именно эту сумму должны покрывать баланс и бюджет вашего ключа.
2. После успешного завершения запуска запрос рассчитывается по использованию, указанному моделью: использование × цена использования, с округлением вверх до целого API-кредита. Оставшаяся часть максимальной суммы автоматически возвращается, однократно, в виде строки refund в балансе API.
3. Стоимость запуска никогда не превышает его максимум, даже если фактическое использование могло бы привести к большей сумме. Стоимость неудачного или отменённого запуска возвращается полностью, как всегда.

Большинство запусков стоят намного меньше максимума; на странице модели отображается «До $X за запуск» для входных данных конструктора, а также стоимость обычного запуска («от» в каталоге). Для немногих моделей, оплачиваемых по времени обработки, использование — это время обработки моделью (помечено approximate).

{
  "object": "quote",
  "credits": 621,
  "usd": "0.621",
  "mode": "metered",
  "label": "Charged by usage",
  "hold": { "credits": 621, "usd": "0.621" },
  "typical": { "credits": 10, "usd": "0.01" },
  "settlement": "usage",
  "display": "$0.01 / 1000 tokens",
  "breakdown": "up to 62.035 × 1000 tokens × $0.01"
}

После запуска поле cost запроса показывает удержанную сумму и фактическую стоимость использования:

{
  "cost": { "credits": 621, "usd": "0.621", "charged": 621, "refunded": 611, "mode": "metered", "held": 621,
            "typical": 10, "settled": { "status": "settled", "credits": 10, "usd": "0.01", "quantity": 1,
            "unit": "1000_tokens", "unit_usd": "0.01", "source": "billed_usage", "approximate": false } }
}

charged − refunded — стоимость запуска. settled.status имеет значение pending в момент между получением результата и расчётом, а в редком случае, когда модель вообще не сообщила данные об использовании, — no_usage (тогда максимум остаётся стоимостью).

Расчёт до запуска#

POST https://api.doitong.com/v1/quote/{model_id} принимает ровно то тело запроса, которое вы отправили бы в run, и возвращает цену этих входных данных: точную цену, за исключением модели с оплатой по использованию, для которой возвращается максимальная стоимость запуска. Он не требует ключа и ничего не стоит:

curl -X POST "https://api.doitong.com/v1/quote/flux/schnell" \
  -H "Content-Type: application/json" \
  -d '{"prompt": "A lighthouse at dusk", "num_images": 2}'

{
  "object": "quote",
  "model": "flux/schnell",
  "credits": 6,
  "usd": "0.006",
  "unit": "megapixel",
  "quantity": 2,
  "unit_credits": 3,
  "mode": "exact",
  "label": "Price per run",
  "display": "$0.003 / megapixel",
  "breakdown": "2 MP (2 images) × 3 API credits",
  "input": { "prompt": "A lighthouse at dusk", "num_images": 2 },
  "warnings": []
}

При наличии ключа расчёт также возвращает balance_credits и balance_usd (ваш баланс API), affordable и key_budget_remaining. Добавьте ?currency=rub, чтобы получить сумму в rub.

Объекты цен#

Все цены в API имеют одинаковую структуру:

• models: price: { "credits": 112, "usd": "0.112", "unit": "second", "display": "$0.112 / second", "credits_display": "112 API credits / second", "from_credits": 560, "from_usd": "0.56", "mode": "exact" } — а также rub, rub_display и from_rub в России или при использовании ?currency=rub;
• requests: cost: { "credits": 560, "usd": "0.56", "charged": 560, "refunded": 0 } (API-кредиты; запрос с оплатой по использованию дополнительно содержит mode, held, typical и settled, см. раздел Оплата по использованию);
• account: GET https://api.doitong.com/v1/account возвращает credits (баланс API), balance: { "credits", "usd" } и storage (стоимость хранилища файлов, использование и месячная оценка).

Возвраты#

• За недействительный запрос (любой 4xx до начала запуска) плата не взимается.
• Стоимость запроса, завершившегося со статусом failed (включая timeout), автоматически возвращается полностью на баланс API.
• Запрос, отменённый до начала запуска, оплаченная сумма возвращается полностью. После начала генерации отмена — лишь запрос: если модель завершит работу, результат будет доставлен, а стоимость списана.
• За успешный запрос metered возвращается неиспользованная часть максимальной суммы.

Объект запроса содержит все данные: cost.credits, cost.charged и cost.refunded.

Хранилище файлов#

Выходные файлы хранятся в нашем хранилище. Вы выбираете режим в аккаунте или для каждого запуска (?storage=):

За постоянное хранилище плата списывается раз в день с баланса API: объём хранимых данных в GB × месячная цена ÷ количество дней в месяце, в строках журнала с типом storage. Доли API-кредита переносятся на следующий день, поэтому за месяц набегает ровно объём в GB × 100 API-кредитов (1 GB = 1024³ байт; хранение 10 GB в течение месяца стоит 1 000 API-кредитов). Баланс никогда не становится отрицательным: если оплатить не удаётся, плата за этот день не списывается, вы получаете электронное письмо, и у вас есть 30 дней на пополнение, прежде чем сохранённые файлы станут временными и будут удалены через 7 дней. Подробнее: Файлы.

Текущие цены#

Это рекомендуемые модели. Все 1 496 моделей и их цены указаны в каталоге моделей и в GET /models (ключ не требуется).

Пополнение#

Пополните баланс API на странице https://doitong.com/developers/dashboard#balance. Если баланс слишком мал, запуск возвращает 402 insufficient_credits с полем top_up_url. Для каждого API-ключа также можно установить собственный бюджет в API-кредитах (см. раздел Аутентификация).