Vidu Q3 Turbo - Image to Video

viduq3-turbo-img2video

viduq3-turbo-img2video Vidu Q3 Turbo - Image to Video viduq3_turbo_img2video vidu

Vidu Q3 Turbo - Image to Video provides faster generation than Vidu Q3 Pro for high-throughput video creation scenarios

Эндпоинты

POST /v1/queue/viduq3-turbo-img2video # Создать задачу

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

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

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

Совет

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

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

curl --request 'POST' 'https://odirouter.ai/model/v1/queue/viduq3-turbo-img2video' \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --location \
  --data-raw '{
  "images": [
    "https://www.gstatic.com/webp/gallery/1.jpg"
  ],
  "prompt": "A cat walking slowly",
  "duration": 5,
  "resolution": "720p",
  "audio": true,
  "aspect_ratio": "16:9"
}'

images array<string> required

First-frame image input. The model uses this image as the starting frame for video generation

Note 1: Supports image Base64 or image URL (must be accessible) Note 2: Only 1 input image is supported Note 3: Supported formats: png, jpeg, jpg, webp Note 4: Image aspect ratio must be less than 1:4 or 4:1 Note 5: Max image size is 50MB Note 6: HTTP POST body must be under 20MB, and encoding must include content type, for example data:image/png;base64,{base64_encode}

---

prompt string

Text prompt describing the video to generate

Limit: Up to 5000 characters

---

audio boolean

Whether to enable direct audio-video generation

false: Outputs a silent video true: Outputs a video with speech and background audio

Options: true, false

Default: true

---

is_rec boolean

Whether to use a recommended prompt

true: System auto-generates one recommended prompt and uses it for generation false: Uses the provided prompt

Note: Enabling recommended prompts consumes an extra 10 credits per task

Options: true, false

Default: false

---

duration integer

Video duration in seconds

Options: 1 - 16

Default: 5

---

seed integer

Random seed. If omitted or set to 0, a random seed is used automatically

---

resolution string

Output resolution

Options: 540p, 720p, 1080p

Default: 720p

---

payload string

Pass-through parameter for custom payload data

Limit: Up to 1048576 characters

---

off_peak boolean

Note: Temporarily unavailable

Off-peak generation mode

true: Off-peak generation false: Immediate generation

Note 1: Off-peak mode consumes fewer credits Note 2: Tasks are processed within 48 hours, unfinished tasks are auto-canceled with credit refund Note 3: You can also cancel off-peak tasks manually

Options: true, false

Default: false

---

watermark boolean

Whether to add a watermark

true: Add watermark false: No watermark

Note 1: Current watermark content is fixed and AI-generated, disabled by default Note 2: You can retrieve watermarked content via watermarked_url

Options: true, false

Default: false

---

wm_position integer

Watermark position in the frame

1: Top-left 2: Top-right 3: Bottom-right 4: Bottom-left

Default: 3

---

wm_url string

Watermark image URL. If omitted, the default AI-generated watermark is used

---

meta_data string

Metadata identifier in JSON string format, passed through without modification

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

If empty, default metadata generated by vidu is used

---

callback_url string

Callback URL. Set callback_url when creating the task, request method is POST

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

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

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

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

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

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

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