Vidu Edit Subjects

vidu-edit-subjects

Vidu Edit Subjects updates an existing subject’s name, style, description, or voice configuration.

Endpoints

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

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

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

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

Request parameters

curl --location 'https://odirouter.ai/model/v1/queue/vidu-edit-subjects' \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --data '{
  "id": "123456789012345678",
  "name": "create1",
  "style": "realistic",
  "description": "Subject description",
  "voice_id": "voice_abc"
}'

id string required

Subject ID generated by Vidu.

name string

New subject name.

Maximum length: 64 characters.

style string

New subject style description.

Maximum length: 100 characters.

description string

New detailed description of the subject.

Maximum length: 2000 characters.

voice_id string

New voice ID for the subject.

Response parameters

{
  "request_id": "task_01hxyz...",
  "response_url": "https://odirouter.ai/model/v1/queue/vidu-edit-subjects/requests/task_01hxyz.../response",
  "status_url": "https://odirouter.ai/model/v1/queue/vidu-edit-subjects/requests/task_01hxyz.../status",
  "cancel_url": "https://odirouter.ai/model/v1/queue/vidu-edit-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.

The final response content contains a JSON string with the edited subject fields: id, name, style, description, and voice_id.

Follow-up operations

Check status

Get result

Cancel task

Error handling