Hy Image 3.5 Preview · API-Referenz und Abrechnung
Erzeuge Bilder aus Text oder Referenzbildern und bearbeite sie über mehrere Schritte.
Sende eine JSON-Anfrage mit Bearer-Authentifizierung und einem gültigen APIMaster-API-Schlüssel.
POST /v1/wand/hunyuan-image/v35-generation · Content-Type: application/json
Anfrageparameter
| Feld | Typ | Beschreibung |
|---|---|---|
model |
string |
hy-image-v3.5-preview (erforderlich). |
messages |
object[] |
Nachrichten in zeitlicher Reihenfolge. Die letzte user-Nachricht enthält die aktuelle Anweisung. Frühere Nachrichten liefern den Bearbeitungskontext. Erforderlich. |
size |
string |
Maße als BreitexHöhe, etwa 4096x4096. Jede Seite misst 256–8192 Pixel. Die Fläche ist auf 16,777,216 Pixel begrenzt. |
seed |
int64 |
Ganzzahl von 0 bis 2⁶³−1. Bei 0 oder ohne Angabe wird ein Zufallswert verwendet. |
generate_max_pixels |
integer |
Gilt ohne size. Stufen: 1,048,576, 2,359,296 (Standard) und 4,194,304. Zwischenwerte werden der nächstgelegenen Stufe zugeordnet. Für 4K verwende size. |
resize_max_pixels |
integer |
Größere Referenzbilder werden proportional verkleinert. Standard: 1,048,576 Pixel. |
session |
string |
Verwende in derselben Bearbeitungssitzung denselben Wert, damit Routing und KV-Cache wiederverwendet werden können. |
footnote |
string |
Eigenes Wasserzeichen unten rechts mit bis zu 16 Unicode-Zeichen. |
use_search_tool |
object |
Verwende {"value":true} oder {"value":false}. Die Suche ist standardmäßig deaktiviert. |
Jede Nachricht enthält role (user, assistant oder tool) und ein content-Array. Nutze type=text mit text oder type=image_url mit image_url:{url:...}. Öffentliche URLs und Daten-URIs mit MIME-Präfix werden unterstützt. Grenzen: 20 MB pro Bild, 20 Bilder und 100,000 Tokens je Kontext. Sende bei Werkzeugergebnissen die passende tool_call_id zurück und kennzeichne bereits erzeugte Bilder mit is_generate:true.
Eine assistant-Nachricht kann reasoning und tool_calls unverändert zurückgeben. Bei einem reinen Werkzeugaufruf kann content entfallen. Das Format ist {id,type:"function",function:{name,arguments}}, wobei arguments eine JSON-Zeichenfolge ist.
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":"Ein blauer Kreis auf weißem Hintergrund"}]}]}'
Antwort
Die Antwort kann aufeinanderfolgende JSON-Frames enthalten. Maßgeblich ist der tatsächliche Content-Type. Die endgültige Bild-URL steht in choices[0].delta.image.url, die Maße in width und height. Auch bei Erfolg kann finish_reason null sein. Prüfe die URL und lade das Bild vor Ablauf herunter. Verwende assembled_history für die nächste Bearbeitungsrunde. Bei Fehler oder Verbindungsabbruch hilft die request_id bei der Diagnose. Eine erneute Generierung kann Kosten verursachen.
Abrechnung
Das Gateway reserviert Guthaben und rechnet einmalig anhand von tokenhub_usage.total_tokens ab. Der aktuelle APIMaster-Preis steht auf der Modellkarte.
