Vidu Edit Subjects

vidu-edit-subjects Vidu edit subjects

Эндпоинты

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

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

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

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

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

curl --location 'https://api.odirouter.ai/model/v1/queue/vidu-edit-subjects' \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --data '{
  "id": "123456789012345678",
  "name": "create1",
  "images": [
    "https://www.gstatic.com/webp/gallery/1.jpg"
  ],
  "style": "realistic",
  "description": "Subject description",
  "voice_id": "voice_abc"
}'

id string required

ID субъекта, созданный Vidu (server_id).

name string

Новое имя субъекта.

Максимальная длина: 64 символа.

images Array[String]

Изображения субъекта, напрямую заменяют исходные изображения субъекта.

Поддерживаются изображения в Base64 или URL изображений (должны быть доступны).

Поддерживается не более 3 изображений.

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

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

После декодирования Base64 длина байтов должна быть меньше 20M, а кодировка должна содержать подходящую строку типа содержимого, например: data:image/png;base64,{base64_encode}

videos Array[String]

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

Если одновременно переданы изображения и видео, применяется только видео.

Этот параметр действует только для субъектов, созданных с референсным видео.

Видео-субъекты поддерживаются только моделью генерации видео по референсу viduq2-pro.

Поддерживается загрузка не более 1 видео длительностью 5 секунд.

Поддерживаемые форматы видео: mp4, avi, mov.

Разрешение видео не должно быть меньше 128*128, а соотношение сторон должно быть меньше 1:4 или 4:1.

После декодирования Base64 длина байтов должна быть меньше 20M, а кодировка должна содержать подходящую строку типа содержимого, например: data:video/mp4;base64,{base64_encode}

style string

Новое описание стиля субъекта.

Максимальная длина: 100 символов.

description string

Новое подробное описание субъекта.

Максимальная длина: 2000 символов.

voice_id string

Новый voice ID для субъекта.

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

{
  "request_id": "task_01hxyz...",
  "response_url": "https://api.odirouter.ai/model/v1/queue/vidu-edit-subjects/requests/task_01hxyz.../response",
  "status_url": "https://api.odirouter.ai/model/v1/queue/vidu-edit-subjects/requests/task_01hxyz.../status",
  "cancel_url": "https://api.odirouter.ai/model/v1/queue/vidu-edit-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]	Список URL изображений отредактированного субъекта.
`videos`	array[string]	Список URL видео отредактированного субъекта.
`voice_id`	string	ID голоса отредактированного субъекта.
`style`	string	Информация о стиле отредактированного субъекта.
`description`	string	Описание отредактированного субъекта.
`created_at`	string	Время создания субъекта.
`creator_id`	string	ID создателя.
`ownership`	string	Тип видимости или владения субъектом.
`status`	string	Статус субъекта, например `enabled`.
`type`	string	Тип субъекта, например `image`.
`user_id`	string	ID пользователя.

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