Vidu Q3 Pro - Text to Video

viduq3-pro-text2video

viduq3-pro-text2video Vidu Q3 Pro - Text to Video viduq3_pro_text2video vidu

Vidu Q3 Pro - Text to Video efficiently generates high-quality audio-video content with stronger motion and richer scene expression

Эндпоинты

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

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

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

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

Совет

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

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

curl --request 'POST' 'https://odirouter.ai/model/v1/queue/viduq3-pro-text2video' \
  --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.",
  "duration": 5,
  "resolution": "720p",
  "audio": true,
  "seed": 0,
  "aspect_ratio": "16:9"
}'

prompt string required

Text prompt describing the video to generate

Limit: Up to 5000 characters

---

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

---

aspect_ratio string

Aspect ratio of the generated video

Options: 16:9, 9:16, 3:4, 4:3, 1:1

Default: 16:9

---

resolution string

Output resolution

Options: 540p, 720p, 1080p

Default: 720p

---

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

---

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

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

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

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

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

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