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.
