curl --request POST \
  --url https://api.aiid.edu.kg/ent/v2/text2video \
  --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>",
  "model": "<string>",
  "prompt": "<string>",
  "images": [
    "<string>"
  ],
  "duration": 123,
  "resolution": "<string>",
  "credits": 123,
  "created_at": "<string>",
  "creations": "<string>"
}

Генерация видео Vidu

Создать видео по тексту(Vidu)

Эта серия поддерживает формат генерации видео OpenAI (подробности см. по ссылке совместимые форматы видео生成Sora ).

Vidu Официальный интерфейс генерации видео; публичный путь соответствует официальному протоколу Vidu.

Текущая публичная модель: viduq3-turbo. Поддерживает генерацию видео по тексту, по изображению, по первым и последним кадрам и по референсу. Эта же модель также поддерживает подключение через совместимый формат Sora с /v1/videos; часто используемые mode: t2v、i2v、i2v_first_last、reference_images.

Дополнены общая структура публичного запроса для официального формата генерации видео Vidu, структура запроса статуса задачи и рекомендуемый шаблон проверки; публичный путь сохраняет формат официального endpoint Vidu.

Поддерживаемые модели: viduq3-turbo

Унифицированные поля запроса:

model (string, обязательно): внешнее имя модели Vidu, текущая публичная версия viduq3-turbo.
prompt (string, необязательно): подсказка для генерации видео; обязательна для генерации видео по тексту, для генерации по изображению/первым и последним кадрам/по референсу передается по необходимости.
images (array[string], необязательно): входные изображения. Для генерации видео по изображению — 1 изображение, для первых и последних кадров — 2 изображения, для генерации по референсу — 1~7 изображений.
videos (array[string], необязательно): для генерации по референсу — необязательный вход с видео-объектом, используется в соответствии с возможностями официальной модели Vidu.
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, необязательно): включить ли прямой вывод аудио и видео.
off_peak (boolean, необязательно): использовать ли поэтапную генерацию.
watermark (boolean, необязательно): добавлять ли водяной знак.

Основные различия моделей/режимов:

Vidu 文生视频: поддерживаемая модель viduq3-turbo; генерация видео по тексту в официальном формате.
Vidu 图生视频: поддерживаемая модель viduq3-turbo; генерация видео по одному изображению в официальном формате.
Vidu 首尾帧生视频: поддерживаемая модель viduq3-turbo; генерация видео по двум изображениям первых и последних кадров в официальном формате.
Vidu 参考生视频: поддерживаемая модель viduq3-turbo; генерация видео по нескольким референсным изображениям в официальном формате.

POST

ent

text2video

curl --request POST \
  --url https://api.aiid.edu.kg/ent/v2/text2video \
  --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>",
  "model": "<string>",
  "prompt": "<string>",
  "images": [
    "<string>"
  ],
  "duration": 123,
  "resolution": "<string>",
  "credits": 123,
  "created_at": "<string>",
  "creations": "<string>"
}

Авторизации

Authorization

string

header

обязательно

Используйте проверку подлинности Bearer Token. Формат: Authorization: Bearer sk-xxxxxx

Тело

application/json

model

enum<string>

обязательно

Vidu — внешнее имя модели, в настоящее время публично доступен viduq3-turbo.

Доступные опции:

viduq3-turbo

Пример:

"viduq3-turbo"

prompt

string

обязательно

Промпт для генерации видео; обязателен для генерации видео по тексту, для генерации по изображению/по первым и последним кадрам/по референсу передавайте по необходимости бизнес-сценария.

Пример:

"A cinematic product ad with smooth camera motion"

images

string<uri>[]

Входное изображение. Для генерации видео по изображению — 1 изображение, для первых и последних кадров — 2 изображения, для генерации видео по референсу — 1–7 изображений.

Пример:

["https://example.com/input.jpg"]

videos

string<uri>[]

При генерации видео по референсу можно использовать необязательный ввод основного объекта видео, в соответствии с возможностями официальной модели Vidu.

subjects

object[]

Ввод в формате, соответствующем формату библиотеки объектов для генерации видео, может включать поля, такие как название объекта, изображение, видео или тембр голоса.

Hide child attributes

subjects.name

string

subjects.images

string<uri>[]

subjects.videos

string<uri>[]

subjects.voice_id

string

subjects.server_id

string

auto_subjects

boolean

duration

integer

Длительность видео, в секундах. viduq3-turbo Обычно 5 секунд, можно задать в пределах, указанных в официальной документации.

Пример:

5

resolution

enum<string>

Разрешение вывода, распространённые значения 540p、720p、1080p.

Доступные опции:

540p,

720p,

1080p

Пример:

"720p"

aspect_ratio

enum<string>

Соотношение сторон вывода, часто используется для генерации видео по тексту/референсу, например 16:9、9:16、1:1.

Доступные опции:

16:9,

9:16,

4:3,

3:4,

1:1

Пример:

"16:9"

seed

integer

Случайное зерно.

movement_amplitude

enum<string>

Амплитуда движения, распространённые значения auto、small、medium、large。

Доступные опции:

auto,

small,

medium,

large

Пример:

"auto"

audio

boolean

Включить ли прямой вывод аудио и видео.

audio_type

enum<string>

Доступные опции:

all,

speech_only,

sound_effect_only

voice_id

string

is_rec

boolean

bgm

boolean

payload

string

off_peak

boolean

Использовать ли генерацию в непиковое время.

watermark

boolean

Добавлять ли водяной знак.

wm_position

enum<integer>

Доступные опции:

1,

2,

3,

4

wm_url

string<uri>

callback_url

string<uri>

Ответ

200 - application/json

Задача успешно создана

task_id

string

обязательно

ID задачи, возвращаемый при создании задачи, используется для ее запроса.

state

enum<string>

обязательно

Статус задачи, распространённые значения created、queueing、processing、success、failed.

Доступные опции:

created,

queueing,

processing,

success,

failed

model

string

prompt

string

images

string[]

duration

integer

resolution

string

credits

integer

Баллы, затраченные на выполнение этой задачи.

created_at

string

creations

string

Запрос задачи(Vidu)Создать видео(HappyHorse)