Vidu Q1 - Reference to Video.

viduq1-reference2video

viduq1-reference2video Vidu Q1 - Reference to Video. viduq1_reference2video vidu

Vidu Q1 - Reference to Video transforms static images into dynamic videos with intelligent motion prediction, supporting reference-based animation and audio sync.

Эндпоинты

POST /v1/queue/viduq1-reference2video # Создать задачу

GET /v1/queue/viduq1-reference2video/requests/{request_id}/status # Проверить статус

GET /v1/queue/viduq1-reference2video/requests/{request_id}/response # Получить результат

PUT /v1/queue/viduq1-reference2video/requests/{request_id}/cancel # Отменить задачу

Совет

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

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

curl --request 'POST' 'https://odirouter.ai/model/v1/queue/viduq1-reference2video' \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --location \
  --data-raw '{
  "prompt": "A clean studio shot of a red apple on a white table, soft natural light.",
  "images": [
    "https://www.gstatic.com/webp/gallery/4.jpg"
  ],
  "subjects": [
    {
      "id": "subject_1",
      "images": [
        "https://www.gstatic.com/webp/gallery/1.jpg"
      ]
    }
  ],
  "audio": true,
  "seed": 42
}'

subjects array required

Subject information from reference images, supports 1 - 7 subjects, total 1 - 7 images

id string required

Subject ID, can be referenced later using @subject_id format

images array required

Image URLs for this subject, each subject supports up to 3 images

Format Requirements: Supports Base64 encoding or image URL (must be accessible) Supported formats: png, jpeg, jpg, webp Image pixels must not be smaller than 128x128, and aspect ratio must be less than 1:4 or 4:1, and 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}

voice_id string

Voice ID to determine the voice timbre in the video, when empty, the system will automatically recommend, refer to the available voice list for options

---

prompt string required

Text description for video generation, maximum 2000 characters

When using subjects parameter, you can use @subject_id to represent subject content, for example: “@1 and @2 eating hotpot together, with voiceover saying everyone loves hotpot.”

---

audio boolean

Whether to use audio-video direct output capability

When true, uses audio-video direct output capability; when false, does not use audio-video direct output capability

Options: true, false

Default: false

---

duration integer

Video duration in seconds

Options: 5

Default: 5

---

seed integer

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

---

aspect_ratio string

Aspect ratio

Options: 16:9, 9:16, 1:1

Default: 16:9

---

resolution string

Resolution parameter

Options: 1080p

Default: 1080p

---

movement_amplitude string

Movement amplitude

Options: auto, small, medium, large

Default: auto

---

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

---

callback_url string

Callback URL

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

{
  "request_id": "task_01hxyz...",
  "response_url": "https://odirouter.ai/model/v1/queue/viduq1-reference2video/requests/task_01hxyz.../response",
  "status_url": "https://odirouter.ai/model/v1/queue/viduq1-reference2video/requests/task_01hxyz.../status",
  "cancel_url": "https://odirouter.ai/model/v1/queue/viduq1-reference2video/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	Текущая позиция в очереди.

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

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

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

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

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