Задание долго не завершается
Ограничьте частоту опроса и покажите пользователю реальный статус, не создавая дубль.
Планируется
Видео: проектирование длительной генерации
Как подготовить сценарий, состояние задания, хранение файла и бюджет до открытия публичной видеогенерации.
API Токенмоста работает
Базовый адрес — https://tokenmost.ru/v1. Создайте ключ в личном кабинете, выберите модель в каталоге и отправьте первый запрос. Методы, которые ещё не доступны, отмечены отдельно.
Как это устроено
Публичная генерация видео Токенмоста пока закрыта. В отличие от текстового ответа, длительная задача требует состояния, идентификатора, ограниченных проверок готовности и сохранения результата; не закладывайте неподтверждённый URL или длительность в рабочий код.
Что потребуется
- Сценарий кадра и движения с правами на исходные материалы.
- Хранилище состояний задания и итогового видео.
- Предельная стоимость и время ожидания для пользователя.
Порядок работы
- Опишите сцену, движение, формат и максимально допустимую длительность.
- Подготовьте состояния pending, running, completed и failed в своём приложении.
- После открытия метода проверьте реальный контракт создания и цену на одном коротком тесте.
- Сохраняйте ID задания и опрашивайте статус с ограниченной частотой.
- Скачайте готовый бинарный файл, проверьте формат, размер и права доступа.
- При ошибке показывайте подтверждённый статус и не создавайте дубль без сверки предыдущего задания.
Готовая конфигурация
Состояние задания в вашем приложении
{
"localJobId": "video-001",
"status": "pending",
"providerJobId": null,
"lastCheckedAt": null,
"outputPath": null
}Что учесть
Публичное видео планируется. JSON — локальная запись состояния, а не подтверждённый контракт будущего API.
Ожидаемый результат
Пользователь видит понятный статус и получает файл только после подтверждённого завершения задания.
Ограничение сейчас
Технические маршруты видео в коде не означают публичный доступ. Не используйте /v1/videos до объявления маршрута, моделей и тарифа.
Расходы
Видеогенерация может быть дорогой; единица оплаты и лимиты ещё не опубликованы. Нужны предварительная оценка и жёсткий бюджет.
Ошибки и диагностика
Файл повреждён
Проверяйте фактический Content-Type и размер скачанного результата.
Потерян job ID
Сохраняйте связь локального задания и ID метода до перехода в ожидание.
Публичный метод не отвечает
Этот маршрут ещё не открыт для внешних ключей. Не повторяйте платные запросы вслепую; проверьте /docs/api-reference.
Стоимость неизвестна
Не считайте технический маршрут готовым тарифом. Дождитесь опубликованной цены и проверьте баланс до первого запроса.