Для сервисов и ботов

Как это выглядит

Пользователь → ваш бот → ваш сервер → Hawklance API
                                ↑
       готовое видео ← вебхук ──┘

Пользователь общается только с вами. Баланс и ключ у вас один на всех, а цены своим пользователям вы задаёте сами.

Что важно предусмотреть

• Свяжите видео с заказом. Передайте в metadata номер заказа и id пользователя: они вернутся в ответе и вебхуке.
• Защититесь от двойного списания. Посылайте заголовок Idempotency-Key с номером заказа. Повтор после обрыва сети вернёт то же видео.
• Возвращайте деньги вовремя. На failed и canceled наши токены уже вернулись. Верните своему пользователю его часть.
• Держите очередь у себя. Одновременных видео не больше, чем позволяет уровень. На 429 concurrency_limit подождите и повторите.
• Скачивайте результат. Ссылка живёт 6 часов. Отправьте файл пользователю сразу или сохраните у себя.
• Следите за балансом. Проверяйте GET /v1/balance и задайте месячный лимит в биллинге.

Сколько это стоит вам

Считайте от цены секунды: таблица цен. Цена каждого ролика есть в ответе, в поле cost.tokens.

Условия

Ваши пользователи тоже обязаны соблюдать правила использования. Об особых условиях и объёмах напишите на hello@hawklance.ai.