APIMaster.ai

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.