APIMaster.ai

Hy Image 3.5 Preview · Dokumentacja API i rozliczenia

Generuj obrazy na podstawie tekstu lub obrazów referencyjnych i edytuj je w kolejnych krokach.

Wyślij żądanie JSON z uwierzytelnianiem Bearer i ważnym kluczem API APIMaster.

POST /v1/wand/hunyuan-image/v35-generation · Content-Type: application/json

Parametry żądania

Pole Typ Opis
model string hy-image-v3.5-preview (wymagane).
messages object[] Komunikaty w kolejności chronologicznej. Ostatni komunikat user zawiera aktualne polecenie. Wcześniejsze komunikaty zapewniają kontekst edycji. Pole wymagane.
size string Wymiary w formacie szerokośćxwysokość, np. 4096x4096. Każdy bok ma od 256 do 8192 pikseli, a powierzchnia najwyżej 16,777,216 pikseli.
seed int64 Liczba całkowita od 0 do 2⁶³−1. Wartość 0 lub pominięcie pola powoduje użycie losowego ziarna.
generate_max_pixels integer Dotyczy żądań bez size. Dostępne wartości to 1,048,576, 2,359,296 (domyślna) i 4,194,304. Wartości pośrednie są zaokrąglane do najbliższego poziomu. Dla 4K użyj size.
resize_max_pixels integer Większe obrazy referencyjne są proporcjonalnie zmniejszane. Wartość domyślna to 1,048,576 pikseli.
session string Zachowaj tę samą wartość w sesji edycji, aby ponownie użyć trasowania i pamięci podręcznej KV.
footnote string Znak wodny w prawym dolnym rogu, maksymalnie 16 znaków Unicode.
use_search_tool object Użyj {"value":true} albo {"value":false}. Wyszukiwanie jest domyślnie wyłączone.

Każdy komunikat zawiera role (user, assistant albo tool) oraz tablicę content. Dla tekstu użyj type=text i text, dla obrazu type=image_url i image_url:{url:...}. Obsługiwane są publiczne adresy URL i identyfikatory URI danych z prefiksem MIME. Limity to 20 MB na obraz, 20 obrazów i 100,000 tokenów na kontekst. Zwróć odpowiedni tool_call_id dla wyniku narzędzia, a wygenerowane obrazy oznacz is_generate:true.

Komunikat assistant może zwrócić reasoning i tool_calls bez zmian. Przy samym wywołaniu narzędzia można pominąć content. Format to {id,type:"function",function:{name,arguments}}, gdzie arguments jest ciągiem JSON.

curl -X POST "https://apimaster.ai/v1/wand/hunyuan-image/v35-generation" \
  -H "Authorization: Bearer $APIMASTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"hy-image-v3.5-preview","size":"1024x1024","messages":[{"role":"user","content":[{"type":"text","text":"Niebieskie koło na białym tle"}]}]}'

Odpowiedź

Odpowiedź może zawierać kolejne ramki JSON. Uwzględnij faktyczny Content-Type. Adres obrazu końcowego znajduje się w choices[0].delta.image.url, a jego wymiary w width i height. W przypadku powodzenia finish_reason może mieć wartość null. Zweryfikuj adres i pobierz obraz przed wygaśnięciem. Przy dalszej edycji użyj assembled_history. Po błędzie lub rozłączeniu zachowaj request_id. Ponowna generacja może wiązać się z kolejną opłatą.

Rozliczenia

Bramka rezerwuje środki i rozlicza żądanie raz na podstawie tokenhub_usage.total_tokens. Aktualna cena APIMaster znajduje się na karcie modelu.