Vidu Create Subjects

vidu-create-subjects Vidu create subjects

Эндпоинты

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://api.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

Имя субъекта (рекомендуется уникальное значение)

images array[string]

Изображения субъекта, необходимо загрузить минимум 1 изображение

Примечание 1: поддерживается передача изображения в формате Base64 или URL изображения (URL должен быть доступен)

Примечание 2: поддерживается максимум 3 изображения

Примечание 3: поддерживаемые форматы изображений: png, jpeg, jpg, webp

Примечание 4: соотношение сторон изображения должно быть меньше 1:4 или 4:1

Примечание 5: размер изображения не должен превышать 50 MB

Примечание 6: длина данных после декодирования Base64 должна быть меньше 20M, а кодировка должна включать подходящую строку типа содержимого, например:

data:image/png;base64,{base64_encode}

videos array[string]

Видео-референс, поддерживается загрузка 1 видео субъекта

Примечание 1: видео субъекта поддерживает только модель генерации по референсу viduq2-pro

Примечание 2: поддерживается максимум 1 видео длительностью 5 секунд

Примечание 3: поддерживаемые форматы видео: mp4, avi, mov

Примечание 4: разрешение видео должно быть не меньше 128*128, соотношение сторон должно быть меньше 1:4 или 4:1, размер файла не должен превышать 100M

Примечание 5: длина данных после декодирования Base64 должна быть меньше 20M, а кодировка должна включать подходящую строку типа содержимого, например:

data:video/mp4;base64,{base64_encode}

voice_id string

ID голоса субъекта, используется только при создании задач с прямым аудио-видео выводом

Примечание 1: если при создании задачи с прямым аудио-видео выводом ID голоса не передан, система автоматически подберет голос

Примечание 2: q2-pro не поддерживает использование ID голоса

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

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

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

Итоговый бизнес-результат находится в output[0].content[0].text как JSON-строка. Распарсите эту строку, чтобы получить следующие поля:

Поле	Тип	Описание
`id`	string	ID субъекта, созданного этим запросом.
`name`	string	Имя пользовательского субъекта, созданного этим запросом.
`images`	array[string]	Параметры изображений созданного субъекта.
`videos`	array[string]	Параметры видео созданного субъекта.
`voice_id`	string	ID голоса, привязанный к созданному субъекту.
`style`	string	Информация о стиле созданного субъекта.
`description`	string	Описание созданного субъекта.
`credits`	int	Количество credits, использованное этим запросом.
`created_at`	string	Время создания субъекта.
`creator_id`	string	ID создателя.
`ownership`	string	Тип видимости или владения субъектом.
`status`	string	Статус субъекта, например `enabled`.
`type`	string	Тип субъекта, например `image`.
`user_id`	string	ID пользователя.

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