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
- 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.integer
Kompressionsstärke von
0 bis 100, nur für jpeg und webp.string
Hintergrund:
transparent, opaque oder auto.transparent erfordert png oder webp; JPEG besitzt keinen Alphakanal.string
Standard:"low"
Moderationsstufe:
auto oder low. Ohne Angabe sendet APIMart ausdrücklich low; ein angegebenes auto wird unverändert weitergegeben.string[]
Referenzbilder für Bild-zu-Bild oder Bearbeitung, maximal
16. Dieses Feld aktiviert automatisch den Bearbeitungsmodus.Es werden nur öffentlich erreichbare HTTP(S)-URLs akzeptiert. Lokale Bilder zuerst über POST /v1/uploads/images hochladen und anschließend die zurückgegebene url verwenden.Größenregeln
- Breite und Höhe müssen Vielfache von
16sein - Keine Seite darf
3840Pixel überschreiten - Das Verhältnis von langer zu kurzer Seite darf höchstens
3:1betragen - Die Gesamtpixelzahl muss zwischen
655.360und8.294.400liegen
Auflösungen über 2560×1440 sind experimentell und können weniger stabil sein.
Verhältnis- und Auflösungszuordnung
size | 1k | 2k | 4k |
|---|---|---|---|
1:1 | 1024×1024 | 2048×2048 | 2880×2880 |
3:2 | 1536×1024 | 2048×1360 | 3520×2336 |
2:3 | 1024×1536 | 1360×2048 | 2336×3520 |
4:3 | 1024×768 | 2048×1536 | 3312×2480 |
3:4 | 768×1024 | 1536×2048 | 2480×3312 |
5:4 | 1280×1024 | 2560×2048 | 3216×2576 |
4:5 | 1024×1280 | 2048×2560 | 2576×3216 |
16:9 | 1536×864 | 2048×1152 | 3840×2160 |
9:16 | 864×1536 | 1152×2048 | 2160×3840 |
2:1 | 2048×1024 | 2688×1344 | 3840×1920 |
1:2 | 1024×2048 | 1344×2688 | 1920×3840 |
21:9 | 2016×864 | 2688×1152 | 3840×1648 |
9:21 | 864×2016 | 1152×2688 | 1648×3840 |
3:1 | 1536×512 | 3072×1024 | 3840×1280 |
1:3 | 512×1536 | 1024×3072 | 1280×3840 |
Bearbeitungsbeispiel
{
"model": "gpt-image-2.5-sunburst",
"prompt": "Produkt und Verpackungstext beibehalten, Hintergrund durch ein cremefarbenes Studio ersetzen und natürlichen Schatten hinzufügen",
"image_urls": ["https://example.com/product.png"],
"resolution": "2k",
"quality": "xhigh"
}
Übermittlung und Aufgabenabfrage
Nach erfolgreicher Übermittlung enthält das Arraydata die neue Aufgaben-ID unter data[0].task_id. Fragen Sie sie über den Aufgabenstatus-Endpunkt alle 2–5 Sekunden ab, bis completed oder failed erreicht ist. Für mehrere Aufgaben steht POST /v1/tasks/batch bereit.
{
"code": 200,
"data": {
"id": "task_01KXXXXXXXXXXXXXXX",
"status": "completed",
"progress": 100,
"cost": 0.01325,
"result": {
"images": [
{
"url": ["https://upload.apimart.ai/f/image/example.png"],
"expires_at": 1789000000
}
]
},
"usage": {
"input_tokens": 16,
"output_tokens": 439,
"total_tokens": 455
}
}
}
data.result.images[].url[]. Laden Sie die Dateien zeitnah herunter und speichern Sie sie dauerhaft.
| Status | Bedeutung |
|---|---|
submitted | Aufgabe übermittelt |
processing | Generierung läuft |
completed | Erfolgreich; result.images ist verfügbar |
failed | Fehlgeschlagen; error.message prüfen; reservierter Betrag wird erstattet |
Abrechnung
GPT-Image-2.5 wird nach tatsächlichem Tokenverbrauch abgerechnet. Aktuelle Kontopreise finden Sie auf der Preisseite oder unter/api/pricing.
| Posten | Preis pro 1 Mio. Token |
|---|---|
| Bildausgabe | $30.00 |
| Bildeingabe | $8.00 |
| Bildeingabe aus Cache | $2.00 |
| Texteingabe | $5.00 |
| Texteingabe aus Cache | $1.25 |
quality bei 1024×1024 | Ausgabe-Token | Offizielle Ausgabekosten |
|---|---|---|
low | 196 | $0.00588 |
medium | 439 | $0.01317 |
high | 1756 | $0.05268 |
xhigh | 3122 | $0.09366 |
max | 7024 | $0.21072 |
Bei
quality: "auto" reserviert der Dienst zunächst den Betrag der teuersten Stufe max für die gewählte Größe. Nach Abschluss wird anhand des tatsächlichen Verbrauchs abgerechnet und die Differenz freigegeben.n > 1 steigt die Reservierung linear. Fehlgeschlagene Aufgaben werden automatisch erstattet.
Grenzen und häufige Fehler
| Punkt | Grenze oder Lösung |
|---|---|
| Bilder pro Anfrage | 1–4 |
| Referenzbilder | Maximal 16 |
| Ausgabeformat | PNG / JPEG / WebP |
| Transparenter Hintergrund | Nur PNG / WebP |
| Teilbilder im Stream | Nicht unterstützt |
| Ungültige Qualität | xhigh / max erfordern GPT-Image-2.5 |
| Ungültige Pixelmaße | Vielfache von 16 innerhalb der Pixel- und Verhältnisgrenzen verwenden |
Response
integer
Antwortstatuscode; 200 bei erfolgreicher Übermittlung.