Оплата и ошибки

Использование видео, безопасные повторы и обращение в поддержку.

Использование

Генерация определяется сохранённым ID видео. Заказанная длительность задаётся полем seconds; итоговое использование показано в завершённой задаче и журнале кабинета. Баланс аккаунта и квота API-ключа — отдельные ограничения.

Восстановление и поддержка

Повторный POST может создать и оплатить ещё одно видео. Если ID известен, повторяйте только GET этой задачи. Таймаут POST без ID оставляет исход неизвестным: проверьте кабинет или обратитесь в поддержку до решения о новом заказе. При 429 или 5xx на GET подождите и снова прочитайте тот же ID; учитывайте Retry-After, если он есть. Локальный таймаут ожидания не отменяет задачу.

СитуацияДействие
400Проверьте JSON, модель, диапазоны полей и роли медиа
401 или запрет доступаПроверьте ключ, срок действия и доступ к модели
Недостаточно средств или квотыПроверьте баланс аккаунта и квоту ключа
404 при GET задачиПроверьте origin, сохранённый ID и аккаунт ключа
Задача failedСохраните ID, проверьте списание и обратитесь в поддержку
Подписанный media URL вернул 403Прочитайте существующую задачу для получения текущей ссылки в пределах исходного срока хранения медиа; GET не продлевает этот срок. После его окончания используйте сохранённую копию или передайте ID поддержке. Не повторяйте POST.

Передайте поддержке модель, ID задачи, время с часовым поясом, HTTP-статус и краткое описание. Для спора о списании добавьте сумму и время операции, для входных медиа — тип, размер, длительность и размеры кадра. Не передавайте полные ключи, подписанные URLs, тела запросов и сырые ошибки через обычные журналы или тикеты.