Vidu Get Subjects

vidu-get-subjects Vidu get subjects

Эндпоинты

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

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

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

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

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

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

ownership string

Владелец субъекта.

Варианты: system (official subjects), private (personal subjects).

По умолчанию: private

subject_ids array[string]

ID субъектов для запроса. Поддерживаются несколько ID.

count integer

Количество результатов для запроса.

По умолчанию: 20

Максимум: 100

next_page_token string

Токен пагинации. Не указывайте его в первом запросе. Если есть дополнительные страницы, ответ вернет next_page_token для следующего запроса.

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

{
  "request_id": "task_01hxyz...",
  "response_url": "https://api.odirouter.ai/model/v1/queue/vidu-get-subjects/requests/task_01hxyz.../response",
  "status_url": "https://api.odirouter.ai/model/v1/queue/vidu-get-subjects/requests/task_01hxyz.../status",
  "cancel_url": "https://api.odirouter.ai/model/v1/queue/vidu-get-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-строка. Распарсите эту строку, чтобы получить следующие поля:

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

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