APIMaster.ai

Vidu Image Q2 · Справочник API

Генерируйте изображения в Vidu Image Q2 по тексту или референсам. Проверяйте задачи и скачивайте результаты.

Создать задачу с POST /v1/wand/vidu-image/generation и запросить ее с GET /v1/wand/vidu-image/tasks/{task_id}. Отправьте ключ APIMaster API в заголовке Authorization: Bearer с обоими запросами. Тело запроса POST передаётся в формате JSON.

Поле Тип Описание
model string Обязательное поле. Используйте vidu-image-q2.
prompt string Обязательное поле. До 2,000 символов. Для генерации изображения по одному тексту опустите референсы (text-to-image).
images string[] Необязательное поле. До семи публичных URL или URI данных в форматах PNG, JPEG/JPG или WebP. Минимальные размеры каждого изображения — 128 × 128 пикселей, допустимое соотношение сторон — от 1:4 до 4:1, максимальный размер файла — 50 MB. Тело запроса может занимать до 20 MB.
aspect_ratio string 16:9 по умолчанию. Варианты: 16:9, 9:16, 1:1, 3:4, 4:3, 21:9, 2:3, 3:2 и auto. Регулировка auto соответствует первому исходному снимку.
resolution string 1080p по умолчанию. Также поддерживает 2K и 4K. Регистр букв учитывается.
seed integer Чтобы использовать случайное начальное значение, опустите поле или укажите 0.
curl -X POST "https://apimaster.ai/v1/wand/vidu-image/generation" \
  -H "Authorization: Bearer $APIMASTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"vidu-image-q2","prompt":"A blue circle on a white background","resolution":"1080p"}'

Проверяйте статус каждые 3–5 секунд с полученным task_id и той же учётной записью. Возможными штатами являются created, queueing, processing, success и failed. После успеха скачать файлы под creations[].url в течение 12 часов. Используйте request_id для отслеживания таких неисправностей, как неверные изображения, просмотр контента, недостаточный кредит, пределы ставок или недостающие задания.

Проверка статуса не запускает повторную генерацию и не приводит к повторному списанию. callback_url не поддерживается. Чтобы вернуть потерянное представление, отправьте стабильную Idempotency-Key 8–128 видимые символы ASCII и следуйте руководству Руководство по восстановлению запроса. Тот же ключ с теми же параметрами возвращает квитанцию восстановления со статусом HTTP 202. Тот же ключ с другими параметрами возвращает HTTP 409.

tokenhub_usage.total_tokens сообщает о платном использовании, которое зависит от разрешения и сколько ссылок было использовано. См. Vidu Image Q2 модель Card для текущей цены APIMaster.