curl --request POST \
--url https://api.apimart.ai/v1/images/generations \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"model": "gpt-image-2.5-flare",
"prompt": "eine gemütliche Leseecke an einem regnerischen Fenster, warmes Lampenlicht",
"size": "1:1",
"resolution": "1k",
"quality": "medium",
"n": 1
}'
{
"code": 200,
"data": [
{
"status": "submitted",
"task_id": "task_01KXXXXXXXXXXXXXXX"
}
]
}
{
"error": {
"code": 400,
"message": "Ungültige Anfrageparameter",
"type": "invalid_request_error"
}
}
{
"error": {
"code": 401,
"message": "Authentifizierung fehlgeschlagen. API-Schlüssel prüfen.",
"type": "authentication_error"
}
}
{
"error": {
"code": 402,
"message": "Kontoguthaben nicht ausreichend",
"type": "payment_required"
}
}
GPT-Image-2.5
GPT-Image-2.5 Bildgenerierung
- Auswahl zwischen gpt-image-2.5-flare und gpt-image-2.5-sunburst
- Asynchrone Verarbeitung mit task_id für spätere Abfragen
- Text-zu-Bild und Bildbearbeitung mit bis zu 16 Referenzbildern
- Lokales Inpainting mit transparenten PNG-Masken
- 15 Seitenverhältnisse, exakte Pixelmaße sowie 1K / 2K / 4K
- Qualitätsstufen low / medium / high / xhigh / max
POST
/
v1
/
images
/
generations
curl --request POST \
--url https://api.apimart.ai/v1/images/generations \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"model": "gpt-image-2.5-flare",
"prompt": "eine gemütliche Leseecke an einem regnerischen Fenster, warmes Lampenlicht",
"size": "1:1",
"resolution": "1k",
"quality": "medium",
"n": 1
}'
{
"code": 200,
"data": [
{
"status": "submitted",
"task_id": "task_01KXXXXXXXXXXXXXXX"
}
]
}
{
"error": {
"code": 400,
"message": "Ungültige Anfrageparameter",
"type": "invalid_request_error"
}
}
{
"error": {
"code": 401,
"message": "Authentifizierung fehlgeschlagen. API-Schlüssel prüfen.",
"type": "authentication_error"
}
}
{
"error": {
"code": 402,
"message": "Kontoguthaben nicht ausreichend",
"type": "payment_required"
}
}
Modellwahl:
gpt-image-2.5-flare ist schneller und eignet sich für hochwertige Alltagsbilder, Serienproduktion und schnelle Prototypen. gpt-image-2.5-sunburst priorisiert Bearbeitungspräzision für finale Produktbilder, Werbemittel und detaillierte mehrstufige Bearbeitung. Beide Modelle werden gleich abgerechnet.curl --request POST \
--url https://api.apimart.ai/v1/images/generations \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"model": "gpt-image-2.5-flare",
"prompt": "eine gemütliche Leseecke an einem regnerischen Fenster, warmes Lampenlicht",
"size": "1:1",
"resolution": "1k",
"quality": "medium",
"n": 1
}'
{
"code": 200,
"data": [
{
"status": "submitted",
"task_id": "task_01KXXXXXXXXXXXXXXX"
}
]
}
{
"error": {
"code": 400,
"message": "Ungültige Anfrageparameter",
"type": "invalid_request_error"
}
}
{
"error": {
"code": 401,
"message": "Authentifizierung fehlgeschlagen. API-Schlüssel prüfen.",
"type": "authentication_error"
}
}
{
"error": {
"code": 402,
"message": "Kontoguthaben nicht ausreichend",
"type": "payment_required"
}
}
Authentifizierung
string
erforderlich
Alle Endpunkte verwenden Bearer-Token-Authentifizierung. Den Schlüssel erhalten Sie auf der API-Schlüssel-Seite.
Authorization: Bearer YOUR_API_KEY
Modell auswählen
| Modell | Stärke | Empfohlene Verwendung |
|---|---|---|
gpt-image-2.5-flare | Schnellere Standardvariante | Social Media, Produktbilder, visuelle Suche, Prototypen und Seriengenerierung |
gpt-image-2.5-sunburst | Höhere Bearbeitungspräzision | Finale Produktbilder, Werbemittel und detaillierte mehrstufige Bearbeitung |
gpt-image-2 kommen xhigh und max hinzu; medium und high benötigen ungefähr ein Viertel der Ausgabe-Token der gleichnamigen Vorgängerstufen.
Anfrageparameter
string
erforderlich
Modellname:
gpt-image-2.5-flare oder gpt-image-2.5-sunburst.string
erforderlich
Textbeschreibung des zu erzeugenden oder zu bearbeitenden Bildes. Beschreiben Sie Motiv, Szene, Komposition, Stil, Beleuchtung und gewünschte Änderungen.
string
Standard:"auto"
Seitenverhältnis oder exakte Pixelmaße.
auto: automatische Wahl anhand von Prompt oder Referenzbildern- Verhältnis:
1:1,3:2,2:3,4:3,3:4,5:4,4:5,16:9,9:16,2:1,1:2,21:9,9:21,3:1,1:3 - Exakte Maße, zum Beispiel
1600x1200
Bei Bild-zu-Bild-Anfragen sollte
size entfallen. Der Dienst berechnet die Maße aus dem Eingabeverhältnis und resolution.string
Standard:"1k"
Auflösungsstufe:
1k, 2k oder 4k. Bei exakten Pixelmaßen wird dieses Feld ignoriert.string
Standard:"auto"
Bildqualität:
low, medium, high, xhigh, max oder auto.xhigh und max werden nur von GPT-Image-2.5 unterstützt. Bei gpt-image-2 führt dies zu HTTP 400; es gibt keine automatische Herabstufung.integer
Standard:"1"
Anzahl der Bilder:
1 bis 4. Als Zahl, nicht als Zeichenkette, senden.string
Standard:"png"
Ausgabeformat:
png, jpeg oder webp.