Vidu Create Subjects

vidu-create-subjects

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

Эндпоинты

POST /v1/queue/vidu-create-subjects # Создать задачу

GET /v1/queue/vidu-create-subjects/requests/{request_id}/status # Проверить статус

GET /v1/queue/vidu-create-subjects/requests/{request_id}/response # Получить результат

PUT /v1/queue/vidu-create-subjects/requests/{request_id}/cancel # Отменить задачу

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

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

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

{
  "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
}

Поле	Тип	Описание
`request_id`	string	Идентификатор задачи для последующей проверки статуса, получения результата и отмены.
`response_url`	string	URL для получения итогового результата.
`status_url`	string	URL для проверки статуса задачи.
`cancel_url`	string	URL для отмены задачи.
`queue_position`	int	Текущая позиция в очереди.