Kurzantwort
- Unterstützt promptbasierte Bildgenerierung mit mehreren Seitenverhältnissen.
- Unterstützt Referenzbilder in reference_images für konsistenteren Stil.
- Offizielle Varianten bieten umfangreichere Generierungssteuerungen für die Produktionsabstimmung.
Wichtige Parameter
- model | string | erforderlich | gemini-3-pro-image-preview | - | Exakte Bildmodell-Kennung, die von ToAPIs bereitgestellt wird.
- prompt | string | erforderlich | - | - | Beschreibender Text für das Bild.
- size | string | optional | 1:1 | 1:1 | 16:9 | 9:16 | 4:3 | 3:4 | 21:9 | Ausgabe-Seitenverhältnis.
- resolution | string | optional | 1K | 1K | 2K | 4K (je nach Modellfähigkeit) | Ausgabeauflösung; die Werte variieren je nach Modellversion.
- reference_images | file[] | optional | - | max 14 | Array aus Referenzbildern zur Steuerung von Stil und Komposition.
Häufige Fehler
- 400 invalid_request_error: Auslöser=Felder im Request-Body fehlen oder ihr Typ ist ungültig.; Behebung=Prüfen Sie die Felder und Werte model/prompt/size/resolution.; Wiederholung=Wiederholen Sie erst nach Korrektur der Parameter.
- 401 authentication_error: Auslöser=API-Schlüssel fehlt oder ist ungültig.; Behebung=Prüfen Sie den Authorization-Header und die Berechtigungen des Schlüssels.; Wiederholung=Nach Korrektur der Authentifizierung erneut versuchen.
- 429 rate_limit_exceeded: Auslöser=Anfragefrequenz, Parallelität oder das aktuelle Kontingent lösen das Upstream-Ratenlimit aus.; Behebung=Wenden Sie zuerst exponentielle Backoff-Wiederholungen an und prüfen Sie dann Anfragefrequenz, Parallelität und Kontingentnutzung.; Wiederholung=Empfohlen ist 1s/2s/4s + Jitter; bei wiederholtem Auslösen drosseln Sie die Übermittlung.










