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.
