Процесс видеозадачи
Генерация видео PopGo выполняется асинхронно: отправьте задачу, сохраните ID, опрашивайте состояние и скачайте результат после завершения.
Endpoint и поля
POST https://api.popgo.site/v1/videos
GET https://api.popgo.site/v1/videos/{task_id}
GET https://api.popgo.site/v1/videos/{task_id}/content
Authorization: Bearer YOUR_API_KEY
model и prompt обязательны. duration / seconds, resolution, aspect_ratio и поля референсов должны соответствовать выбранной модели.
curl -X POST https://api.popgo.site/v1/videos \
-H "Authorization: Bearer YOUR_API_KEY" -H "Content-Type: application/json" \
-d '{"model":"YOUR_MODEL","prompt":"A bamboo forest in morning mist, slow camera movement","seconds":5,"resolution":"480p","aspect_ratio":"16:9"}'
Опрос и прогресс
Обычные состояния: queued, in_progress, completed, failed. Показывайте progress, только если поле пришло; при его отсутствии показывайте обработку без выдуманного процента. После completed используйте URL или /content. Ошибка 400 обычно связана с моделью, типом, длительностью, разрешением, соотношением или референсом. Оплата зависит от модели, а не от числа опросов.
Опрос, тайм-ауты и повторы
Создавайте один раз, сохраняйте id, модель, время, разрешение и режим. Тайм-аут может произойти после принятия: сначала найдите прежнюю задачу. Повтор опроса/скачивания того же id не создаёт новое видео.
Обычно3–5s, C10–15s, Kling около10s с ожиданием минимум15 минут. Для429/502/503 и временных сетевых ошибок применяйте ограниченный backoff и Retry-After. Исправьте400, авторизацию/права для401/403. По сроку клиента покажите тайм-аут ожидания, сохраните ID и не объявляйте сбой сервиса.
progress может быть0 до100 или отсутствовать. model,usage,разрешение,реальная длительность,fps тоже могут отсутствовать. Сохраняйте входные параметры и проверяйте файл; отсутствие usage не означает бесплатно. queued/in_progress не являются ошибками.
URL может истечь или требовать авторизацию: предпочитайте PopGo /content. После completed ограниченно повторяйте скачивание, не создание. Дайте время крупным файлам и проверьте видео вместо JSON-ошибки. Не отправляйте API Key PopGo внешнему хосту.
Пять этапов диагностики
| Этап | Что доказывает | Чего не доказывает |
|---|---|---|
| Проверка интерфейса | Локальное принятие режима,числа,источника | Нет запроса не означает отказ сервиса |
| Разбор и возможности PopGo | 400/500 до создания или после | Отсутствие логов не доказывает неисправность поставщика |
| Исходящий запрос | Поля и роли материалов | Правильные поля не гарантируют доступность файла |
| Принятие и опрос | ID,состояние,стадия ошибки | 200 и ID не доказывают использование или бесплатность |
| Итоговый файл | Эффект на кадры,объект,движение,звук | URL не доказывает качество |
Запишите модель,время,фиктивный ID,режим,число/источник и короткую ошибку без ключей,cookies,подписанных URL и личных файлов. Разделяйте мощность и модерацию; проверяйте счёт даже при ошибке. Исправьте причину до новых затрат.