APIMaster.ai

Vidu Video Q4 Preview · Справочник API

Создайте видео с одного изображения или ссылок, затем опрашивайте задачу APIMaster.

Использовать POST /v1/wand/vidu/image-to-video для одного стартового изображения или POST /v1/wand/vidu/reference-to-video для исходного поколения. Опрос с GET /v1/wand/vidu/tasks/{task_id}. Используйте JSON для представления и Bearer аутентификацию для каждого запроса. Для этой модели не существует только текстового поколения и отдельной конечной точки запуска/конечной версии.

Поле Тип Описание
model string Обязательное поле. Используйте vidu-video-q4-preview.
images string[] Image-to-video требует точно одного изображения. Reference-to-video принимает до 15 изображения или subjects. Используйте публичную URLs или данные URI в PNG, JPEG/JPG, или WebP. Коэффициент аспекта должен быть 1:4 и 4:1. Каждый снимок URL может быть до 50 MB. Base64 снимки ограничены 15 MB перед кодированием и 20 MB в целом.
subjects object[] Для reference-to-video в качестве альтернативы images. Установите name и от одного до трех images. Ссылайтесь на объект с @name в срочном режиме.
prompt string Требуется для reference-to-video. До 2,000 символы для прямых ссылок на изображения или 5,000 для объектов и image-to-video. Image-to-video игнорирует это поле при включении is_rec.
auto_subjects boolean Тема для библиотеки reference-to-video. По умолчанию: false.
audio boolean По умолчанию true для image-to-video и false для reference-to-video. Справочное видео с аудио требует subjects и эксплицитное значение true.
audio_type string При включении звука используйте all (по умолчанию), speech_only, или sound_effect_only.
is_rec boolean Автоматическая оперативная рекомендация по image-to-video. Позволяя ей, мы расширяем использование задач.
duration integer От 3 до 16 секунды, с 5 в качестве по умолчанию.
resolution string 540p, 720p (по умолчанию), 1080p, 2K или 4K.
aspect_ratio string Только Reference-to-video. Использовать 16:9 (по умолчанию), 9:16, 3:4, 4:3 или 1:1. Image-to-video следует входному снимку.
seed integer Чтобы использовать случайное начальное значение, опустите поле или укажите 0.
payload string Факультативные данные о применении до 1,048,576 символов.
watermark boolean По умолчанию: false.
wm_url string Факультативная заказная водяная марка URL. По умолчанию водяной знак появляется в левой верхней части. API не принимает wm_position.
curl -X POST "https://apimaster.ai/v1/wand/vidu/image-to-video" \
  -H "Authorization: Bearer $APIMASTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"vidu-video-q4-preview","images":["https://example.com/reference.jpg"],"prompt":"Slow camera pan","duration":5,"resolution":"720p"}'

Проверяйте статус каждые 5–10 секунд с task_id и той же учётной записью. К штатам относятся created, queueing, processing, success и failed. После успеха creations[].url является видео и creations[].cover_url его обложка. Загрузить временные линии в часы 12. Оставьте request_id, когда сообщите о неисправности.

Используйте Idempotency-Key из 8–128 видимых ASCII символов для получения представления. Тот же ключ с теми же параметрами возвращает квитанцию восстановления со статусом HTTP 202. Тот же ключ с другими параметрами возвращает HTTP 409. См. Руководство по восстановлению запроса. Запрашиваемые таймеры могут быть пересмотрены без создания нового видео.

Врата урегулируют поколение один раз. tokenhub_usage.total_tokens сообщает о платном использовании. См. Vidu Video Q4 Preview модель Card для текущей цены APIMaster.