Руководство
Каталог моделей и биллинг
Выбор моделей, понимание карточек цен, проверка возможностей и доступности
Каталог моделей и биллинг
Каталог моделей — это точка входа для выбора модели и знакомства с ценами вызовов; он показывает каталог моделей, которые платформа в настоящее время может публично предоставить. Фактический диапазон вызовов по-прежнему определяется группой вызовов, к которой относится API Key, и доступностью в реальном времени.
Как выбрать модель
- Ищите по названию или фильтруйте по бренду модели, возможностям и типу интерфейса;
- откройте подробности и проверьте поддерживаемые интерфейсы, доступные группы и тип цены;
- с помощью
GET /v1/modelsпроверьте, что ID модели виден этому Key; - в бэкенде бизнес-системы отправляйте запросы с возвращённым ID модели.
Поля каталога моделей
GET /v1/models возвращает модели, доступные для вызова текущему Key; описание полей:
| Поле | Тип | Описание |
|---|---|---|
data[].id | string | ID модели; указывайте его как есть при отправке запроса |
data[].object | string | Фиксированное значение model |
data[].created | integer | Время записи в каталоге (Unix-секунды) |
data[].owned_by | string | Идентификатор поставщика модели, только для справки |
data[].supported_endpoint_types | string[] | Типы интерфейсов, доступные для модели |
Каталог моделей служит только для проверки «может ли этот Key вызвать эту модель»; конкретные ограничения параметров (число референсных изображений, спецификации входного видео, длительность и чёткость вывода и т. д.) определяются страницей деталей модели и ошибками параметров, возвращаемыми интерфейсом. Платформа не угадывает параметры за модель и не выполняет молчаливую деградацию для неподдерживаемых параметров.
Как читать карточку цены
| Отображение | Значение |
|---|---|
| Вход / выход | Оплата отдельно за входные и выходные Token; единица отображается как 1K или 1M Token. |
| Кэшированный вход / запись кэша | Отображается только для моделей с поддержкой кэширования промптов. |
| За вызов | Фиксированная цена за каждый успешный запрос. |
| Видео с оплатой по объёму | Видеомодели показываются по действующей цене; разрешения, длительности и режимы без указанной цены не отображаются. |
Цены используются для оценки; фактическое списание определяется фактическим объёмом использования запроса, группой запроса и записями биллинга на сервере.
Видеомодели
Серии doubao-seedance и seedance показывают отдельную матрицу цен, разделённую по «наличию видеовхода» и «разрешению вывода»; для поддерживаемых ячеек указывается стоимость видео, для неподдерживаемых комбинаций явно отображается «не поддерживается».
При чтении матрицы сначала определите, будет ли в этот раз передан видеовход, затем выберите нужное разрешение. Например, если загружаются только текст или референсные изображения, смотрите столбец «Без видеовхода»; если видео передаётся как вход, смотрите столбец «С видеовходом». Не предполагайте неотображённые цены или возможности по соседним уровням.
Перед вызовом убедитесь, что:
- ID модели присутствует в ответе
/v1/models; - запрос использует видеоинтерфейс
/v1/video/generations, а не текстовый интерфейс; - референсные изображения или видео соответствуют публичным требованиям к параметрам этой модели;
- бэкенд сохраняет и опрашивает ID задачи, возвращённый для асинхронной задачи.
Ссылки на материалы и модели
Загрузка материалов в библиотеку не зависит от модели: материал нужно загрузить один раз, а платформа подготовит соответствующую ссылку на материал для текущей модели. Один и тот же ID материала можно напрямую переключать между разными моделями; для смены модели достаточно изменить поле model в запросе.
Какие модели используют одну и ту же библиотеку материалов и какие модели поддерживают материалы реальных людей, см. в разделе Интерфейсы библиотеки материалов.
Биллинг и счета
Каталог моделей показывает описание цен, а не итоговую сумму расчёта. Текстовые модели обычно рассчитываются по фактическому входу, выходу и использованию кэша; модели изображений, аудио или видео могут рассчитываться за вызов, по длительности или по определённой моделью единице измерения.
Асинхронные задачи, такие как видео, рассчитываются по завершении: успешная отправка только принимает задачу и не списывает средства заранее; после завершения задачи в счёте появляется только одна запись фактического списания. Перед отправкой платформа проверяет, покрывает ли баланс аккаунта (или квота текущего API Key) предварительную оценку этой задачи; при недостатке сразу возвращается читаемое сообщение, а задача не создаётся. После завершения задачи можно сверить модель, время, ID запроса и фактическое списание в кошельке или записях использования.
Ошибка валидации параметров (HTTP 400) означает, что запрос не был принят, и обычно не создаёт расходов на задачу генерации; правила биллинга, ошибок и возврата после возврата ID задачи определяются конфигурацией цен этой модели и платформы.
Изменения доступности
Если карточка модели не отображается или модели нет в /v1/models, значит она сейчас не входит в доступный каталог этого Key; переключитесь на аналогичную модель и не хардкодьте в клиенте названия недоступных моделей.
«Нет доступных каналов» и «Модель временно недоступна» означают, что в текущий период маршрутизация к этой модели невозможна, а не что формат API Key неверен. Сначала обновите список моделей или переключитесь на аналогичную модель; если недоступность сохраняется, обратитесь в поддержку платформы и укажите ID запроса.