Vidu Get Subjects

vidu-get-subjects

Vidu Get Subjects retrieves subjects by ownership, subject IDs, result count, or pagination token.

Endpoints

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

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

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

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

Request parameters

curl --location 'https://odirouter.ai/model/v1/queue/vidu-get-subjects' \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --data '{
  "ownership": "system"
}'

ownership string

Subject ownership.

Options: system (official subjects), private (personal subjects).

Default: private

subject_ids array[string]

Subject IDs to query. Multiple IDs are supported.

count integer

Number of results to query.

Default: 20

Maximum: 100

next_page_token string

Pagination token. Omit it on the first request. If more pages exist, the response returns next_page_token for the next request.

Response parameters

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

Follow-up operations

Check status

Get result

Cancel task

Error handling