curl --request POST \
--url https://api.aiid.edu.kg/ent/v2/img2video \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"model": "viduq3-turbo",
"prompt": "A cinematic product ad with smooth camera motion",
"duration": 5,
"resolution": "720p",
"aspect_ratio": "16:9"
}
'{
"task_id": "<string>",
"state": "created",
"model": "<string>",
"prompt": "<string>",
"images": [
"<string>"
],
"duration": 123,
"resolution": "<string>",
"created_at": "<string>",
"creations": "<string>"
}Создать видео по изображению(Vidu)
Эта серия поддерживает формат генерации видео OpenAI (подробности см. по ссылке совместимые форматы видео生成Sora ).
Vidu Официальный интерфейс генерации видео; публичный путь соответствует официальному протоколу Vidu.
viduq3-turbo, viduq2, vidu2.0 поддерживают генерацию видео из текста, изображения, начального и конечного кадров или референсов в соответствии со своими возможностями; также доступно подключение через совместимый формат /v1/videos Sora.
Vidu Q4: для vidu-q4 фиксированное разрешение 720p, для vidu-q4-540p — 540p; поддерживается генерация видео длительностью от 3 до 16 секунд. Требуется как минимум 1 изображение, поддерживается до 15 референсных изображений; к референсной генерации можно приложить до 3 аудиофайлов MP3, каждый длительностью от 3 до 12 секунд и размером до 50 МБ. Генерация только по тексту, указание начального и конечного кадров и референсное видео не поддерживаются. Несколько изображений используются как общие референсы и не обозначают позиции начала и конца. Задачи можно создавать через POST /v1/videos, POST /api/v3/contents/generations/tasks или в формате Vidu с помощью POST /ent/v2/img2video, POST /ent/v2/reference2video. Для унифицированной точки входа рекомендуется использовать mode=reference_images; при наличии аудио используйте mode=reference_material. Для референсного аудио можно использовать audio_urls; в формате Seedance также можно использовать параметр audio_url стандартного content. Булево поле audio обозначает переключатель генерации аудио и используется отдельно от списка URL референсного аудио. Разрешение должно соответствовать имени модели.
Дополнены общая структура публичного запроса для официального формата генерации видео Vidu, структура запроса статуса задачи и рекомендуемый шаблон проверки; публичный путь сохраняет формат официального endpoint Vidu.
Поддерживаемые модели: viduq3-turbo, viduq2, vidu2.0, vidu-q4, vidu-q4-540p
Унифицированные поля запроса:
model(string, обязательно): Внешнее имя модели Vidu. Vidu Q4 поддерживает только генерацию видео из изображения и по референсам с изображениями; Q3/Q2/V2 используют свои соответствующие возможности.prompt(string, необязательно): подсказка для генерации видео; обязательна для генерации видео по тексту, для генерации по изображению/первым и последним кадрам/по референсу передается по необходимости.images(array[string], необязательно): Входные изображения. Для генерации из одного изображения — 1 изображение; для генерации по референсам в Vidu Q4 — от 1 до 15 изображений, используемых как общие референсы. Количество начальных и конечных кадров и референсов для старых моделей определяется их возможностями.videos(array[string], необязательно): Входное основное видео предоставляется только в соответствии с возможностями старых моделей; Vidu Q4 не поддерживает референсные видео.subjects(array[object], необязательно): вход в формате библиотеки объектов для генерации по референсу; может включать поля, такие как имя объекта, изображение, видео или тембр.duration(integer, необязательно): длительность видео в секундах.viduq3-turboОбычно 5 секунд, можно задать в пределах, указанных в официальной документации.resolution(string, необязательно): выходное разрешение, распространенные значения:540p、720p、1080p.aspect_ratio(string, необязательно): выходное соотношение сторон, часто используется для генерации видео по тексту/по референсу, например16:9、9:16、1:1.seed(integer, необязательно): случайное зерно.movement_amplitude(string, необязательно): амплитуда движения, распространенные значения:auto、small、medium、large.audio(boolean, необязательно): включить ли прямой вывод аудио и видео.audio_urls(array[string], необязательно): Референсное аудио для Vidu Q4: до 3 файлов MP3, каждый длительностью от 3 до 12 секунд и размером до 50 МБ; указывается отдельно от булевого переключателя audio.off_peak(boolean, необязательно): использовать ли поэтапную генерацию.watermark(boolean, необязательно): добавлять ли водяной знак.
Основные различия моделей/режимов:
Vidu 文生视频: Поддерживаемые модели: viduq3-turbo, viduq2, vidu2.0; генерация видео из текста в официальном формате.Vidu 图生视频: Поддерживаемые модели: viduq3-turbo, viduq2, vidu2.0; генерация видео из одного изображения в официальном формате.Vidu 首尾帧生视频: Поддерживаемые модели: viduq3-turbo, viduq2, vidu2.0; генерация видео из двух изображений — начального и конечного кадров — в официальном формате.Vidu 参考生视频: Поддерживаемые модели: viduq3-turbo, viduq2, vidu2.0; генерация видео из нескольких референсных изображений в официальном формате.Vidu Q4 720p 单图: поддерживается модель vidu-q4; пример с одним изображением или двумя изображениями и двумя MP3-фрагментами в качестве референсов; несколько изображений используются как общие референсы, без указания начального и конечного кадров. Перед вызовом замените URL примеров материалов.Vidu Q4 540p 单图: поддерживается модель vidu-q4-540p; пример с одним изображением или двумя изображениями и двумя MP3-фрагментами в качестве референсов; несколько изображений используются как общие референсы, без указания начального и конечного кадров. Перед вызовом замените URL примеров материалов.
curl --request POST \
--url https://api.aiid.edu.kg/ent/v2/img2video \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"model": "viduq3-turbo",
"prompt": "A cinematic product ad with smooth camera motion",
"duration": 5,
"resolution": "720p",
"aspect_ratio": "16:9"
}
'{
"task_id": "<string>",
"state": "created",
"model": "<string>",
"prompt": "<string>",
"images": [
"<string>"
],
"duration": 123,
"resolution": "<string>",
"created_at": "<string>",
"creations": "<string>"
}Авторизации
Используйте проверку подлинности Bearer Token.
Формат: Authorization: Bearer sk-xxxxxx
Тело
Внешнее имя модели Vidu. Vidu Q4 поддерживает только генерацию видео из изображения и генерацию видео по референсу с изображением; Q3/Q2/V2 сохраняют свои соответствующие возможности.
viduq3-turbo, viduq2, vidu2.0, vidu-q4, vidu-q4-540p "viduq3-turbo"
Входные изображения. Генерация по одному изображению создаёт 1 изображение; Vidu Q4 при генерации с референсами создаёт 1–15 изображений, при этом изображения используются как общие референсы. Для устаревших моделей начальный и конечный кадры, а также количество референсов используются в соответствии с их возможностями。
1 element["https://example.com/input.jpg"]
Промпт для генерации видео; обязателен для генерации видео по тексту, для генерации по изображению/по первым и последним кадрам/по референсу передавайте по необходимости бизнес-сценария.
"A cinematic product ad with smooth camera motion"
Ввод основного объекта видео предоставляется только в соответствии с возможностями старой модели; Vidu Q4 не поддерживает референсные видео.
Ввод в формате, соответствующем формату библиотеки объектов для генерации видео, может включать поля, такие как название объекта, изображение, видео или тембр голоса.
Длительность видео, в секундах. viduq3-turbo Обычно 5 секунд, можно задать в пределах, указанных в официальной документации.
5
Разрешение вывода, распространённые значения 540p、720p、1080p.
540p, 720p, 1080p "720p"
Соотношение сторон вывода, часто используется для генерации видео по тексту/референсу, например 16:9、9:16、1:1.
16:9, 9:16, 4:3, 3:4, 1:1 "16:9"
Случайное зерно.
Амплитуда движения, распространённые значения auto、small、medium、large。
auto, small, medium, large "auto"
Включить ли прямой вывод аудио и видео.
Эталонное аудио Vidu Q4: не более 3 MP3-фрагментов, каждый длительностью 3–12 секунд и размером до 50 МБ; отдельно от булевого переключателя audio.
3all, speech_only, sound_effect_only Использовать ли генерацию в непиковое время.
Добавлять ли водяной знак.
1, 2, 3, 4 Ответ
Задача успешно создана
ID задачи, возвращаемый при создании задачи, используется для ее запроса.
Статус задачи, распространённые значения created、queueing、processing、success、failed.
created, queueing, processing, success, failed