Kling Video V3
Три модели используют API видеозадач PopGo, но отличаются количеством изображений, семантикой кадров и форматом результата. В этой интеграции входные видео- и аудиореференсы не доступны. Столбец «аудио» в документации сервиса не описывает входной аудиореференс.
Различия моделей
| Модель | Изображения | Выходное аудио (документация сервиса) | Разрешение |
|---|---|---|---|
kling-video-v3 | До 2; первое изображение — первый кадр, второе — последний | Поддерживается | 720p / 1080p / 4K |
kling-video-v3-omni | До 7 референсных изображений | Поддерживается | 720p / 1080p / 4K |
kling-video-v3-turbo | Только один первый кадр | Аудио не поддерживается | 720p / 1080p |
Поля и значения по умолчанию
| Поле | Тип | Правило |
|---|---|---|
model | string | Обязательно; публичный идентификатор модели из таблицы |
prompt | string | Обязательно; опишите объекты, движение и камеру |
seconds / duration | integer | Целое число 3–15 секунд; задавайте явно; в интерфейсе по умолчанию 5 секунд |
resolution | string | 720p / 1080p / 4K в зависимости от модели; в интерфейсе 720p, у сервиса 4K; Turbo не поддерживает 4K |
aspect_ratio | string | 16:9 / 9:16 / 1:1; по умолчанию 16:9; учитывайте правила изображений ниже |
reference_images | object[] | Массив объектов с url или image_url; публичный HTTP(S) URL либо полный Data URL изображения |
Использование reference_images
Для прямого API используйте массив объектов ниже. PopGo также нормализует файлы Canvas и поля кадров, но не отправляйте несколько синонимов одновременно. Публичный URL не обязателен: локальное изображение можно закодировать полным Data URL. Страница просмотра, страница входа и путь к файлу не являются URL изображения.
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 person turns toward the camera",
"seconds": 5,
"resolution": "720p",
"reference_images": [
{"url": "YOUR_IMAGE_URL"}
]
}'
Для генерации из текста опустите reference_images. Для изображений сохраняйте порядок: у стандартной модели два изображения — первый и последний кадры, а не два обычных стилевых референса. Omni использует несколько изображений как референсы объектов/стиля. Turbo отклоняет больше одного изображения.
Соотношение сторон и результат
В документации зафиксирован первый кадр 1024×1536 и результат 2352×3524 у стандартной модели: пропорции следуют изображению. Для определённой композиции сначала обрежьте изображение. Не рассчитывайте, что aspect_ratio переопределяет любой режим. Canvas скрывает этот параметр в режиме первого кадра.
Один пример Omni с запросом 5 секунд и 4K дал 3840×2160, 24 fps, около 5.042 секунды, 8.9 Mbps и 5.6 MB. Это наблюдение, а не гарантия битрейта или размера.
Неподдерживаемые и неподтверждённые поля
Ни одна из этих трёх моделей сейчас не предоставляет reference_video, video_reference, reference_audio или управление движением через референс. generate_audio относится к выходной дорожке, а не входному материалу. Текущий пресет Canvas не показывает этот переключатель. Название Omni не доказывает поддержку управления движением.
Неописанные поля, например quality, могут игнорироваться. HTTP 200 не доказывает применение параметра. Не выводите поддержку seed или watermark из общих соглашений: сначала проверьте контракт и результат.
Четыре особенности опроса
- Прогресс может оставаться 0 до completed / 100. Это само по себе не означает зависание; не выдумывайте промежуточные проценты.
- Поле model при опросе может быть пустым; сохраняйте модель исходного запроса.
- Поле usage может отсутствовать; проверяйте учёт PopGo и не считайте задачу бесплатной.
- Разрешение, длительность и частота кадров могут отсутствовать; исследуйте загруженный файл. Временные метки ответа не всегда показывают реальное время выполнения.
Три документированных запуска заняли примерно 140, 200 и 420 секунд. Опрашивайте раз в 10 секунд и допускайте ожидание не менее 15 минут; это не SLA. После локального тайм-аута запрашивайте прежнюю задачу, а не создавайте новую.
Ошибки и исправления
| Симптом | Действие |
|---|---|
| 400 invalid parameters | Проверьте допустимые длительности, пропорции, разрешения и число изображений; не повторяйте неизменённый запрос |
| 404 model or task missing | Проверьте публичную модель, права токена и идентификатор задачи PopGo |
| 503 no available account / 502 temporary service failure | Используйте ограниченные повторы с задержкой; после тайм-аута создания сначала найдите существующую задачу |
| Видео создано, но изображение проигнорировано | Проверьте фактический reference_images и доступность материала, затем сравните кадр/объект; одного ID задачи недостаточно |
| Turbo с 4K или аудиопараметрами | Удалите неподдерживаемые параметры; выберите 720p / 1080p |
Загружайте через прокси /content PopGo или доступный URL результата. Предусмотрите время для крупных файлов и никогда не передавайте ключ PopGo стороннему медиахосту. Примеры опроса, скачивания и повторов: Видеозадачи. Тарифы: Модели и цены.