Vidu Q2 Pro Fast - Start End to Video

viduq2-pro-fast-start-end2video

viduq2-pro-fast-start-end2video Vidu Q2 Pro Fast - Start End to Video viduq2_pro_fast_start_end2video vidu

Vidu Q2 Pro Fast - Start end to Video generates videos between first and last frames with optimized performance.

Эндпоинты

POST /v1/queue/viduq2-pro-fast-start-end2video # Создать задачу

GET /v1/queue/viduq2-pro-fast-start-end2video/requests/{request_id}/status # Проверить статус

GET /v1/queue/viduq2-pro-fast-start-end2video/requests/{request_id}/response # Получить результат

PUT /v1/queue/viduq2-pro-fast-start-end2video/requests/{request_id}/cancel # Отменить задачу

Совет

Добавляйте заголовок аутентификации в каждый запрос: Authorization: Bearer YOUR_API_KEY.

Параметры запроса

curl --request 'POST' 'https://odirouter.ai/model/v1/queue/viduq2-pro-fast-start-end2video' \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --location \
  --data-raw '{
  "images": [
    "https://www.gstatic.com/webp/gallery/4.jpg",
    "https://www.gstatic.com/webp/gallery/1.jpg"
  ],
  "prompt": "A smooth transition between the scenes",
  "duration": 4,
  "aspect_ratio": "16:9",
  "resolution": "720p",
  "movement_amplitude": "auto"
}'

images array required

Start and end frame images, supports input of two images, the first uploaded image is considered the start frame, the second image is considered the end frame, the model will generate video using the images passed in this parameter

Format Requirements: The two input images for start and end frames need similar resolutions, the ratio of start frame resolution / end frame resolution should be between 0.8 ~ 1.25, and the image aspect ratio must be less than 1:4 or 4:1 Supports Base64 encoding or image URL (must be accessible) Supported formats: png, jpeg, jpg, webp Image size must not exceed 50MB HTTP request POST body must not exceed 20MB, and encoding must include appropriate content type string. Example: data:image/png;base64,{base64_encode}

---

prompt string

Text description for video generation, maximum 2000 characters

If using is_rec recommended prompt parameter, the model will not consider the prompt entered in this parameter

---

is_rec boolean

Whether to use recommended prompt

When true, the system automatically recommends a prompt and uses the prompt content to generate the video, the number of recommended prompts = 1; when false, generates video based on the input prompt

Note: Enabling recommended prompts consumes additional points per task

Options: true, false

Default: false

---

duration integer

Video duration in seconds

Options: 1, 2, 3, 4, 5, 6, 7, 8

Default: 5

---

seed integer

Random seed, when not provided or set to 0, uses a random number instead, manual setting uses the specified seed

---

resolution string

Resolution parameter

Options: 720p, 1080p

Default: 720p

---

movement_amplitude string

Movement amplitude

Options: auto, small, medium, large

Default: auto

---

bgm boolean

Whether to add background music to the generated video

When true, the system will automatically select and add appropriate music from the preset BGM library; when false, no BGM is added

BGM has no time limit, the system automatically adapts to video duration

Options: true, false

Default: false

---

payload string

Pass-through parameter, no processing required, only data transmission, maximum 1048576 characters

---

off_peak boolean

Note: Temporarily unavailable

Off-peak mode, off-peak mode consumes fewer points. Tasks submitted in off-peak mode will be generated within 48 hours. Tasks that cannot be completed will be automatically canceled and points will be refunded

When true, generates video during off-peak hours; when false, generates video immediately

Options: true, false

Default: false

---

watermark boolean

Whether to add a watermark. When true, a watermark is added; when false, no watermark is added

Currently watermark content is fixed and AI-generated, by default no watermark is added

Options: true, false

Default: false

---

wm_position integer

Watermark position, indicating where the watermark appears on the image

Options: 1 (Top-left), 2 (Top-right), 3 (Bottom-right), 4 (Bottom-left)

Default: 3

---

wm_url string

Watermark content, provided as an image URL, when not provided, the default AI-generated watermark content is used

---

meta_data string

Metadata identifier, JSON format string, pass-through field

You can customize the format or use the example format. Example:

{
  "Label": "your_label",
  "ContentProducer": "yourcontentproducer",
  "ContentPropagator": "your_content_propagator",
  "ProduceID": "yourproductid",
  "PropagateID": "your_propagate_id",
  "ReservedCode1": "yourreservedcode1",
  "ReservedCode2": "your_reserved_code2"
}

When this parameter is empty, the default metadata identifier generated by vidu is used

---

callback_url string

Callback URL

Параметры ответа

{
  "request_id": "task_01hxyz...",
  "response_url": "https://odirouter.ai/model/v1/queue/viduq2-pro-fast-start-end2video/requests/task_01hxyz.../response",
  "status_url": "https://odirouter.ai/model/v1/queue/viduq2-pro-fast-start-end2video/requests/task_01hxyz.../status",
  "cancel_url": "https://odirouter.ai/model/v1/queue/viduq2-pro-fast-start-end2video/requests/task_01hxyz.../cancel",
  "queue_position": 0
}

Поле	Тип	Описание
request_id	string	Идентификатор задачи для последующей проверки статуса, получения результата и отмены.
response_url	string	URL для получения итогового результата.
status_url	string	URL для проверки статуса задачи.
cancel_url	string	URL для отмены задачи.
queue_position	int	Текущая позиция в очереди.

Следующие операции

Проверить статус

Получить результат

Отменить задачу

Обработка ошибок