Vidu Create Subjects

vidu-create-subjects

Vidu Create Subjects allows creating reusable subjects with image and video references and voice configuration.

Endpoints

POST /v1/queue/vidu-create-subjects # Create task

GET /v1/queue/vidu-create-subjects/requests/{request_id}/status # Check status

GET /v1/queue/vidu-create-subjects/requests/{request_id}/response # Get result

PUT /v1/queue/vidu-create-subjects/requests/{request_id}/cancel # Cancel task

Request parameters

curl --request 'POST' 'https://odirouter.ai/model/v1/queue/vidu-create-subjects' \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --location \
  --data-raw '{
  "name": "create1",
  "images": [
    "https://www.gstatic.com/webp/gallery/1.jpg"
  ]
}'

name string required

Subject name (recommended to be unique)

images array[string]

Subject images, at least 1 image must be uploaded

Note 1: Supports image Base64 encoding or image URL (ensure accessible)

Note 2: Maximum 3 images supported

Note 3: Supported image formats: png, jpeg, jpg, webp

Note 4: Image aspect ratio must be less than 1:4 or 4:1

Note 5: Image size must not exceed 50 MB

Note 6: Please note that the byte length after base64 decode must be less than 20M, and the encoding must include an appropriate content type string, for example:

data:image/png;base64,{base64_encode}

videos array[string]

Video reference, supports uploading 1 subject video

Note 1: Only the viduq2-pro reference generation model supports video subjects

Note 2: Maximum 1 video of 5 seconds supported

Note 3: Supported video formats: mp4, avi, mov

Note 4: Video resolution must not be less than 128*128, aspect ratio must be less than 1:4 or 4:1, and size must not exceed 100M

Note 5: Please note that the byte length after base64 decode must be less than 20M, and the encoding must include an appropriate content type string, for example:

data:video/mp4;base64,{base64_encode}

voice_id string

Subject voice ID, used only when creating audio-video direct output tasks

Note 1: If no voice ID is provided when creating audio-video direct output tasks, the system will automatically recommend a voice

Note 2: q2-pro does not support using a voice ID

Response parameters

{
  "request_id": "task_01hxyz...",
  "response_url": "https://odirouter.ai/model/v1/queue/vidu-create-subjects/requests/task_01hxyz.../response",
  "status_url": "https://odirouter.ai/model/v1/queue/vidu-create-subjects/requests/task_01hxyz.../status",
  "cancel_url": "https://odirouter.ai/model/v1/queue/vidu-create-subjects/requests/task_01hxyz.../cancel",
  "queue_position": 0
}

Field	Type	Description
`request_id`	string	Task ID used for all follow-up operations.
`response_url`	string	URL to fetch the final result.
`status_url`	string	URL to query task status.
`cancel_url`	string	URL to cancel the task.
`queue_position`	int	Current queue position.

Follow-up operations

Check status

Get result

Cancel task

Error handling