Skip to main content
Verwenden Sie für neue Integrationen Bildgenerierung mit dem einheitlichen Protokoll /ai/v1/images/generations. Die kompatiblen Schnittstellen auf dieser Seite bleiben verfügbar. Fragen Sie die Modell-Schema-API ab, wählen Sie den Endpunkt anhand von path und lesen Sie dessen request.schema; verlassen Sie sich nicht auf die Array-Reihenfolge.

Aktuelle Modellübersicht

Diese Übersicht zeigt aktuell verfügbare Modelle. Sie bedeutet nicht, dass alle Modelle dieselben Felder akzeptieren. Wählen Sie den Endpunkt über path im Modell-Schema und lesen Sie dessen request.schema.

API-Schnittstelle

Request-URL

<model_path> hat die Form <provider/model_id>, z. B. <openai/gpt-image-1.5>, <qianfan/qwen-image>.

Request-Header

Request-Parameter

Allgemeine Parameter

OpenAI-Modell-Parameter

Flux-Modell-Parameter

Qwen-Modell-Parameter

Doubao-Modell-Parameter

Die tatsächlich erzeugbare Anzahl an Bildern wird nicht nur von max_images, sondern auch von der Anzahl der bereitgestellten Referenzbilder beeinflusst. Eingabe-Referenzbilder + finale Bildanzahl ≤ 15.

Anwendungsbeispiele

OpenAI

gpt-image-2

Dies ist ein OpenAI-Modell für Bildbearbeitung. Verwenden Sie den vollständigen Modellnamen gpt-image-2; image2 ist keine gültige Modell-ID. Wenn der Endpunkt b64_json zurückgibt, speichern die folgenden Beispiele das Ergebnis als edited.png.

Google Imagen

Qwen

Doubao

Flux

  • flux-2-flex und flux-2-pro sind asynchrone Endpoints, die einen zweistufigen Request erfordern. Diese Serie ist extrem schnell, nahezu sofortig.

FLUX – Einstufiges Zeichnen

Flux – Asynchrones Zeichnen

Schritt 1: Zeichnungsanfrage senden Beispiel-Ausgabe:
Schritt 2: Link zum generierten Bild abrufen
Get Image

Ideogram V3

  1. Versionen unterhalb V3 (V_2, V_1 usw.) sind alte Schnittstellen und werden nicht unterstützt.
  2. Die zurückgegebenen Links erfordern einen Proxy-Zugriff.

Fehlerantworten und Kompatibilitätsfehlercodes

Dieser Abschnitt gilt für die Legacy-Schnittstellen /v1/images/* auf dieser Seite. Die neuen Schnittstellen unter /ai/v1/images/* verwenden einen eigenen Bildfehlervertrag. Die Antwortstrukturen und Fehlercodes beider Schnittstellengruppen müssen getrennt verarbeitet werden. Eine allgemeine Fehlerantwort der Legacy-Bildschnittstelle sieht wie folgt aus. param ist optional und tid wird in der Regel am Ende von message angefügt und nicht als separates Feld zurückgegeben:

Feedback zu HTTP-5xx-Fehlern senden

Wenn eine Anfrage HTTP 5xx zurückgibt, senden Sie Feedback und fügen Sie die in message enthaltene tid bei.
Zusätzlich zu den stabilen Kompatibilitätsfehlercodes in der Tabelle kann die Legacy-Bildschnittstelle weitere dynamische code und bereinigte message vom Modellanbieter oder aus der Kompatibilitätskette zurückgeben. Diese dynamischen Codes bilden eine offene Menge. Clients dürfen Codes außerhalb der Tabelle nicht als stabile Aufzählung behandeln. Die in message enthaltene tid ist die ID zur Anfrageverfolgung.
Zuletzt aktualisiert: 2026-09-01