Использование Маркетплейса моделей
Маркетплейс моделей — это единая точка входа для всех доступных моделей Tianshu, их групп, актуальных коэффициентов и статуса доступности. Перед настройкой любого клиента рекомендуем сначала зайти сюда и уточнить имя модели и группу.
Как смотреть
- Откройте Маркетплейс моделей (просмотр доступен без входа).
- Слева — список доступных групп токенов, то есть тех групп, которые вы выбираете при создании токена.
- Выберите группу — справа отобразятся карточки всех моделей этой группы.
На каждой карточке модели вы увидите:
- Имя модели: скопируйте его напрямую и впишите в поле «Модель / Model» вашего клиента.
- Скидочный коэффициент: например, «скидка 20%» или «скидка 80%»; чем ниже коэффициент, тем дешевле.
- Статус доступности: зелёная точка означает, что модель сейчас доступна, и показывает задержку последней проверки.
Как понимать скидочный коэффициент
У каждой модели в её группе есть коэффициент, и итоговая стоимость = базовая цена модели × коэффициент группы × фактический объём.
- Коэффициент < 1 означает скидку:
0.8= скидка 20%,0.5= скидка 50%. - Коэффициент > 1 означает надбавку:
1.5= доплата 50%.
Всё определяется данными в реальном времени
Модели и рыночные ставки меняются быстро, поэтому в этой документации конкретные цены не приводятся. Всегда ориентируйтесь на актуальные коэффициенты в Маркетплейсе моделей — там всегда самая свежая информация.
Почему стоит сначала зайти сюда
Многие помнят только название группы, но не знают, какие именно модели в ней есть, и после настройки сталкиваются с «модель не существует». Уточнив в Маркетплейсе моделей группу + имя модели заранее, вы избежите подавляющего большинства проблем настройки.
Как посмотреть документацию модели
У части моделей — в первую очередь видео — на карточке появляется дополнительная кнопка Документация. Она открывает описание, написанное именно для этой модели:
- Эндпоинты — по какому адресу создать задачу, узнать прогресс и забрать результат
- Режимы генерации — какие поля включают текст-в-видео, изображение-в-видео, первый/последний кадр и т. д. (самая частая ошибка при работе с видеомоделями)
- Параметры запроса — значение каждого, допустимые значения и значение по умолчанию
- Примеры запроса / ответа — JSON, который можно скопировать как есть
- Примеры вызова — полные тела запросов для типовых сценариев
То же самое доступно через Подробности → вкладка API.
Если кнопки Документация нет, отдельного описания для модели пока нет — вызывайте её стандартным способом.
TIP
Адреса в документации уже готовы к использованию: копируйте и вызывайте, заменять ничего не нужно.
Что дальше
Чтобы узнать, для каких сценариев подходит каждая группа, см. Группы токенов.
