curl --request GET \
--url 'https://toapis.com/v1/pricing?model=seedance-2-5' \
--header 'Authorization: Bearer <token>'
{
"object": "list",
"currency": "USD",
"data": [
{
"id": "seedance-2-5",
"type": "video",
"prices": [
{
"group": "default",
"conditions": {"resolution": "720p", "has_video_input": false},
"charge_type": "per_token",
"price_basis": "total_tokens",
"unit": "1m_tokens",
"unit_price": "4"
}
]
}
],
"has_more": false,
"next_after": ""
}
Аккаунт
Цены и фактические списания
Получение доступных для API Key цен и подтверждённых списаний из ответов генерации
GET
/
v1
/
pricing
curl --request GET \
--url 'https://toapis.com/v1/pricing?model=seedance-2-5' \
--header 'Authorization: Bearer <token>'
{
"object": "list",
"currency": "USD",
"data": [
{
"id": "seedance-2-5",
"type": "video",
"prices": [
{
"group": "default",
"conditions": {"resolution": "720p", "has_video_input": false},
"charge_type": "per_token",
"price_basis": "total_tokens",
"unit": "1m_tokens",
"unit_price": "4"
}
]
}
],
"has_more": false,
"next_after": ""
}
Для запросов из материкового Китая используйте
https://toapis.cn как Base URL. Замените https://toapis.com на https://toapis.cn в примерах ниже.GET /v1/pricing возвращает тарифы на модели изображений и видео, доступные текущему API Key. В ответе уже учтены индивидуальная фиксированная цена или скидка клиента и действующая цена группы.
Эндпоинт возвращает каталог тарифов, а не расчёт стоимости одной генерации. Он не резервирует и не фиксирует цену и не вычисляет итоговую стоимость по параметрам запроса генерации.
Авторизация
string
обязательно
API Key для генерации в формате
Bearer YOUR_API_KEY.Параметры запроса
string
Точный ID модели. Если параметр не указан, возвращаются все доступные модели изображений и видео.
string
Фильтр по
image или video.integer
по умолчанию:"100"
Число возвращаемых моделей. Допустимый диапазон: от
1 до 100.string
Курсор пагинации из поля
next_after предыдущего ответа.model значение seedance-2-5, seedance-2-5-cn или seedance-2-5-global. Отдельного параметра региона нет.
curl --request GET \
--url 'https://toapis.com/v1/pricing?model=seedance-2-5' \
--header 'Authorization: Bearer <token>'
{
"object": "list",
"currency": "USD",
"data": [
{
"id": "seedance-2-5",
"type": "video",
"prices": [
{
"group": "default",
"conditions": {"resolution": "720p", "has_video_input": false},
"charge_type": "per_token",
"price_basis": "total_tokens",
"unit": "1m_tokens",
"unit_price": "4"
}
]
}
],
"has_more": false,
"next_after": ""
}
Поля цены
string
Валюта цены. Сейчас это
USD.string
Тип объекта. Всегда
list.array
Доступные модели. Каждый элемент содержит точный
id, type и массив prices, который может быть пустым.boolean
Указывает, доступна ли следующая страница.
string
Курсор для следующего запроса. Пустая строка, если
has_more равно false.string
Группа маршрутизации, для которой действует цена. Для API Key с автоматическим выбором группы может вернуться несколько групп.
object
Условия применения цены, включая значения модели по умолчанию, если они влияют на тарификацию. Запрос генерации должен соответствовать этим значениям.
string
per_request, per_second или per_token.string
Основа расчёта:
request, output_seconds, total_tokens или text_input_tokens.string
Единица цены:
request, second или 1m_tokens.string
Действующая цена за единицу в USD в виде десятичной строки. Индивидуальная цена клиента и коэффициент группы уже учтены; не умножайте цену на коэффициент группы повторно.
input_unit_price, input_image_unit_price, free_input_image_count, minimum_charge_usd или image_token_prices. Для тарифов по времени могут возвращаться pricing_period, pricing_timezone, pricing_schedule_version и pricing_peak_windows.
Для тарификации токенов изображений объект image_token_prices может содержать text_input, cached_text_input, image_input, cached_image_input и image_output. Все суммы указаны в USD за 1 миллион токенов.
Каталог возвращает только цены, для которых существует хотя бы один включённый канал-кандидат, совместимый с указанными условиями. Эта проверка не резервирует маршрут и не проверяет текущее состояние канала. Если сервис не может безопасно опубликовать полный тариф, модель может вернуться с пустым массивом prices. Пустой массив или отсутствие цены не означает бесплатное использование.
Поля фактического списания
Если списание можно подтвердить, ответ генерации содержит следующий объект:{
"billing": {
"status": "settled",
"credits": "100",
"cost_usd": "0.5"
}
}
| Поле | Значение |
|---|---|
status | pending, settled или refunded |
credits | Подтверждённое число списанных ToAPIs Credits в виде десятичной строки |
cost_usd | То же подтверждённое списание в USD в виде десятичной строки |
pending означает, что итоговая сумма ещё не определена, поэтому поля суммы отсутствуют. refunded означает подтверждённое нулевое итоговое списание. Если весь объект billing отсутствует, платформа не смогла подтвердить безопасное публичное значение; это не означает бесплатный запрос.
Объект может находиться в следующих ответах:
- запрос асинхронной задачи изображения
GET /v1/images/generations/{task_id} - запрос асинхронной задачи видео
GET /v1/videos/generations/{task_id} data.billingв Task Webhook- верхнеуровневый
billingв совместимых нестриминговых ответах синхронной генерации или редактирования изображений
Ошибки
| Статус | Код | Значение |
|---|---|---|
400 | invalid_request_error | Неподдерживаемый параметр запроса или неверный type / limit |
401 / 403 | зависит от причины | API Key неверен, истёк, ограничен или не имеет доступа к аккаунту или группе |
404 | model_not_found | Точный ID модели недоступен этому API Key |
503 | pricing_unavailable | Индивидуальные цены нельзя безопасно загрузить; подстановка публичной цены не выполняется |
Cache-Control: private, no-store.