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.
