APIMaster.ai

Vidu Image Q2 · Dokumentacja API

Generuj obrazy w Vidu Image Q2 na podstawie tekstu lub obrazów referencyjnych. Sprawdzaj zadania i pobieraj wyniki.

Utwórz zadanie za pomocą POST /v1/wand/vidu-image/generation i zapytaj GET /v1/wand/vidu-image/tasks/{task_id}. Wyślij APIMaster Klucz API Authorization: Bearer nagłówek z obydwoma wnioskami. Treść żądania POST ma format JSON.

Pole Typ Opis
model string Wymagane. Stosowanie vidu-image-q2.
prompt string Wymagane. Maksymalnie 2,000 znaków. Aby wygenerować obraz na podstawie samego tekstu, pomiń obrazy referencyjne (text-to-image).
images string[] Opcjonalnie. Do siedmiu publicznych adresów URL lub URI danych w formacie PNG, JPEG/JPG lub WebP. Każdy obraz musi mieć co najmniej 128 × 128 pikseli, proporcje od 1:4 do 4:1 i rozmiar do 50 MB. Treść całego żądania nie może przekraczać 20 MB.
aspect_ratio string 16:9 domyślnie. Opcje to 16:9, 9:16, 1:1, 3:4, 4:3, 21:9, 2:3, 3:2 i auto. Ustawienie auto następuje po pierwszym obrazie odniesienia.
resolution string 1080p domyślnie. Obsługuje również 2K i 4K. Wielkość liter ma znaczenie.
seed integer Pomiń pole lub ustaw 0, aby użyć losowego ziarna.
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"}'

Sprawdzaj stan co 3–5 sekund za pomocą zwróconego task_id i tego samego konta. Możliwe stany to created, queueing, processing, success i failed. Po pomyślnym pobraniu plików pod creations[].url w ciągu 12 godzin. Użyj request_id, aby wyśledzić błędy, takie jak nieprawidłowe obrazy, przegląd treści, niewystarczający kredyt, limity cenowe lub brakujące zadania.

Sprawdzenie stanu nie uruchamia ponownego generowania ani nie nalicza kolejnej opłaty. callback_url nie jest obsługiwany. Aby odzyskać utracone złożenie, wysłać stajnię Idempotency-Key z 8–128 widoczne ASCII znaki i postępuj zgodnie z Przewodnik odzyskiwania żądań. Ten sam klucz i te same parametry zwracają potwierdzenie odzyskania z kodem HTTP 202. Ten sam klucz z innymi parametrami zwraca HTTP 409.

tokenhub_usage.total_tokens zgłasza billable use, który zależy od rozdzielczości i ile referencji użyto. Patrz Vidu Image Q2 karta modelowa dla bieżącego APIMaster Cena.