Vidu Q2 - Reference to Image

viduq2-reference2image Vidu Q2 Reference to Image генерирует изображения с согласованным стилем и персонажами, поддерживает генерацию изображений на основе референсов и текста в изображения, обладая продвинутыми возможностями сохранения персонажей.

Эндпоинты

POST /v1/queue/viduq2-reference2image # Создать задачу

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

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

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

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

curl --request 'POST' 'https://api.odirouter.ai/model/v1/queue/viduq2-reference2image' \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --location \
  --data-raw '{
  "prompt": "A character in a new scene",
  "images": [
    "https://www.gstatic.com/webp/gallery/3.jpg"
  ],
  "resolution": "1080p",
  "aspect_ratio": "1:1",
  "style": "general"
}'

images Array[String]

Референсные изображения. Поддерживается передача от 0 до 7 изображений.

Модель генерирует изображения с согласованными субъектами на основе входных изображений.

Требования к формату:

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

Поддерживаемые форматы: png, jpeg, jpg, webp

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

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

Тело HTTP-запроса не должно превышать 20MB, а кодировка должна включать подходящую строку типа содержимого. Пример: data:image/png;base64{base64_encode}

prompt string required

Текстовое описание для генерации изображения, не более 2000 символов

Примечание: модель viduq2 поддерживает генерацию изображения по тексту. Если использовать viduq2 без загрузки изображений, модель сгенерирует изображение на основе текста в этом параметре

resolution string

Разрешение изображения

Варианты: 1080p, 2K, 4K

По умолчанию: 1080p

aspect_ratio string

Соотношение сторон

Примечание: в режиме auto соотношение сторон сгенерированного изображения будет соответствовать первому входному изображению

Варианты: auto, 16:9, 9:16, 1:1, 3:4, 4:3, 21:9, 2:3, 3:2

По умолчанию: 16:9

seed integer

Случайный seed. Значение по умолчанию — случайное число seed. Значение, заданное вручную, переопределяет стандартный случайный seed

payload string

Сквозной параметр. Не обрабатывается, используется только для передачи данных, максимум 1048576 символов

callback_url string

URL обратного вызова

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

{
  "request_id": "task_01hxyz...",
  "response_url": "https://api.odirouter.ai/model/v1/queue/viduq2-reference2image/requests/task_01hxyz.../response",
  "status_url": "https://api.odirouter.ai/model/v1/queue/viduq2-reference2image/requests/task_01hxyz.../status",
  "cancel_url": "https://api.odirouter.ai/model/v1/queue/viduq2-reference2image/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	Текущая позиция в очереди.

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