Zum Hauptinhalt springen
POST
Dieser Endpunkt arbeitet asynchron. Nach dem Absenden die Task-ID aus data[0].task_id lesen und Status und Bild über die Task-Abfrage abrufen. Alle 3–5 Sekunden abfragen; empfohlenes Gesamtzeitlimit des Clients: 5 Minuten. Bei completed oder failed stoppen.

Request-Header

string
erforderlich
Bearer-Authentifizierung: Bearer <token>. <token> ist Ihr APIMart API Key.

Request-Parameter

string
erforderlich
Fester Wert: hy-image-v3.5-preview.
string
erforderlich
Textbeschreibung für Generierung oder Bearbeitung. Chinesisch und Englisch werden unterstützt; darf nicht leer sein.
string
Standard:"auto"
Ausgabeseitenverhältnis oder exakte Pixelmaße.
  • Seitenverhältnis: 1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9, 21:9.
  • Exakte Pixelmaße: etwa 2000x1104; die untenstehenden Grenzen gelten.
  • auto oder nicht angegeben: Das Modell entscheidet anhand des Prompts.
Bei exakten Pixelmaßen bestimmt resolution nicht die Bildgröße.
string
Standard:"1K"
Auflösungsstufe: 1K, 2K oder 4K; Standard: 1K.Bei exakten Pixelmaßen bestimmt dieses Feld nicht die Größe. Immer einen unterstützten Wert verwenden; andere Werte führen zu HTTP 400.
integer
Exakte Ausgabebreite in Pixeln. Muss zusammen mit height angegeben werden und hat Vorrang vor size und resolution.Breite: 256–8192; Breite × Höhe darf 8.294.400 nicht überschreiten. Vielfache von 16 werden empfohlen.
integer
Exakte Ausgabehöhe in Pixeln. Muss zusammen mit width angegeben werden.Höhe: 256–8192; Breite × Höhe darf 8.294.400 nicht überschreiten. Vielfache von 16 werden empfohlen.
string[]
Öffentliche URLs für maximal 5 Referenzbilder. Ohne Bilder: Text-zu-Bild; mit Bildern: referenzbasierte Generierung über denselben Endpunkt.JPEG, PNG und WEBP werden unterstützt. Empfohlen: unter 7MB pro Bild. URLs müssen öffentlich zugänglich sein.
string
Inhalte, die im Bild nicht erscheinen sollen.
integer
Zufalls-Seed; muss eine nicht negative Ganzzahl sein. 0 oder Auslassen bedeutet zufällig.
integer
Standard:"1"
Nur ein Bild pro Anfrage. Nur 1 ist zulässig; andere Werte führen zu HTTP 400.

Größenauswahl

Priorität: width / height als Paar → exakte Pixel in size → Seitenverhältnis oder auto in size mit resolution. Bei exakten Pixelmaßen müssen Breite und Höhe jeweils 256–8192 betragen, insgesamt maximal 8.294.400 Pixel. Für beide werden Vielfache von 16 empfohlen.

Beispiel mit exakten Pixelmaßen

Alternativ width und height weglassen und "size": "2000x1104" übergeben.

Beispiel mit Referenzbild

Beispiel-URLs durch tatsächlich öffentlich erreichbare Bild-URLs ersetzen. Für mehrere Referenzen weitere URLs in image_urls angeben, insgesamt maximal 5.

Antwort auf die Übermittlung

integer
Antwortstatuscode; 200 bedeutet Erfolg.
array
Ergebnis der Task-Übermittlung.

Task-Ergebnisse abfragen

Beispiel einer erfolgreichen Antwort (Bild-URL ist ein Platzhalter):
  • pending / processing: weiter abfragen.
  • completed: Bild-URL aus data.result.images[0].url[0] lesen; url ist ein Array aus Zeichenfolgen.
  • failed: Abfragen stoppen und Ursache aus data.error.message lesen. Vollständige Erstattung. Prompt-Verstöße und abgelehnte Inhalte werden ebenfalls als Fehlschlag behandelt.
Bilder werden im Plattform-CDN gespeichert. Vor dem in expires_at angegebenen Zeitpunkt herunterladen und sichern.

Abrechnung

Abrechnung pro Bild. Aktuelle Preise unter Modellpreise.
  • Bei Seitenverhältnissen wird nach der resolution-Stufe abgerechnet.
  • Bei exakten Pixelmaßen bestimmt die kürzere Seite die Stufe:
Fehlgeschlagene Tasks werden vollständig erstattet.

Häufige Parameterfehler

Folgende Fälle geben synchron HTTP 400 zurück, ohne Task-Erstellung oder Kosten: