Images API

Zwei Endpunkte: Generieren (Text → Bild) und Bearbeiten (Bild + Text → Bild). Beide Antworten folgen der OpenAI-Standardstruktur data[0].b64_json.

Seedream und Qwen-Image unterstützen /v1/images/edits nicht. Bild-zu-Bild läuft bei ihnen über den Endpunkt generations, allerdings mit unterschiedlichen Feldern für Referenzbilder: Seedream verwendet image, Qwen verwendet input_images — verwechseln Sie die beiden nicht. Wenn Sie bei Gemini die Auflösung steuern möchten (512 bis 4K), nutzen Sie das native Gemini-Protokoll. Die Parameterunterschiede der einzelnen Reihen finden Sie auf der jeweiligen Seite der Reihe.

Schnellstart

Eine minimale, lauffähige Anfrage: ein Bild mit 1024×1024 generieren, dekodieren und als output.png speichern.

import base64
from openai import OpenAI
 
client = OpenAI(
    api_key="YOUR_OFOX_API_KEY",
    base_url="https://api.ofox.ai/v1",
    timeout=600,  # die Bild-API antwortet synchron und braucht oft länger
)
 
resp = client.images.generate(
    model="openai/gpt-image-2.5-flare",
    prompt="Ein roter Apfel auf einem weißen Tisch",
    size="1024x1024",
    quality="low",
)
 
with open("output.png", "wb") as f:
    f.write(base64.b64decode(resp.data[0].b64_json))

curl https://api.ofox.ai/v1/images/generations \
  --max-time 600 \
  -H "Authorization: Bearer $OFOX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "openai/gpt-image-2.5-flare",
    "prompt": "Ein roter Apfel auf einem weißen Tisch",
    "size": "1024x1024",
    "quality": "low"
  }' | jq -r '.data[0].b64_json' | base64 --decode > output.png

Alle Reihen werden auf dieselbe Weise aufgerufen; für einen Modellwechsel ändern Sie nur model. Wertebereiche und reihenspezifische Parameter unterscheiden sich; siehe die einzelnen Parameter unten.

Bilder generieren

POST https://api.ofox.ai/v1/images/generations

Anfrageparameter

Die folgenden Werte und Standardwerte gelten für die Reihe GPT Image (gpt-image-2.5-flare, gpt-image-2.5-sunburst, gpt-image-2). Abweichungen anderer Reihen sind jeweils vermerkt. Gemessene Details: Reihe GPT Image.

Antwort

{
  "created": 1777385517,
  "data": [
    { "b64_json": "iVBORw0KGgoAAAANSUhEUgAA…", "index": 0 }
  ],
  "model": "openai/gpt-image-2.5-flare",
  "size": "1024x1024",
  "quality": "low",
  "usage": {
    "input_tokens": 13,
    "input_tokens_details": { "text_tokens": 13 },
    "output_tokens": 196,
    "output_tokens_details": { "image_tokens": 196 },
    "total_tokens": 209
  }
}

Bilder bearbeiten

POST https://api.ofox.ai/v1/images/edits

Anfrageparameter

multipart/form-data: Die Parameter werden als Formularfelder gesendet, die Bilddatei wird hochgeladen. Werte und Standardwerte gelten auch hier für die Reihe GPT Image.

Antwort

Gleiche Struktur wie beim Generierungs-Endpunkt; usage enthält zusätzlich die Eingabe-Tokens der Referenzbilder:

{
  "created": 1777385669,
  "data": [
    { "b64_json": "iVBORw0KGgoAAAANSUhEUgAA…", "index": 0 }
  ],
  "model": "openai/gpt-image-2",
  "size": "auto",
  "quality": "low",
  "usage": {
    "input_tokens": 1041,
    "input_tokens_details": { "image_tokens": 1024, "text_tokens": 17 },
    "num_input_images": 1,
    "output_tokens": 358,
    "total_tokens": 1399
  }
}

Die übrigen Felder entsprechen der Antwort des Generierungs-Endpunkts.

Aufruf

import base64
from openai import OpenAI
 
client = OpenAI(api_key="YOUR_OFOX_API_KEY", base_url="https://api.ofox.ai/v1", timeout=600)
 
with open("apple.png", "rb") as f:
    resp = client.images.edit(
        model="openai/gpt-image-2",
        image=f,
        prompt="Färbe den Apfel grün, lass alles andere unverändert",
        size="auto",
        quality="low",
    )
 
with open("apple_edited.png", "wb") as out:
    out.write(base64.b64decode(resp.data[0].b64_json))

import OpenAI, { toFile } from 'openai'
import fs from 'node:fs'
 
const client = new OpenAI({
  apiKey: 'YOUR_OFOX_API_KEY',
  baseURL: 'https://api.ofox.ai/v1',
  timeout: 600_000, // Millisekunden
})
 
const resp = await client.images.edit({
  model: 'openai/gpt-image-2',
  image: await toFile(fs.createReadStream('apple.png'), 'apple.png'),
  prompt: 'Färbe den Apfel grün, lass alles andere unverändert',
  size: 'auto',
  quality: 'low',
})
 
fs.writeFileSync('apple_edited.png', Buffer.from(resp.data[0].b64_json!, 'base64'))

curl -X POST 'https://api.ofox.ai/v1/images/edits' \
  --max-time 600 \
  -H 'Authorization: Bearer YOUR_OFOX_API_KEY' \
  -F 'model="openai/gpt-image-2"' \
  -F 'prompt="Färbe den Apfel grün, lass alles andere unverändert"' \
  -F 'image=@/path/to/apple.png' \
  -F 'size="auto"' \
  -F 'quality="low"'

Das Feld image erwartet einen lokalen Dateipfad (in cURL mit dem Präfix @), keine URL.

Gemessener Vergleich:

Original	Bearbeitet

Fehler

Im Fehlerfall erhalten Sie einen HTTP-Fehlerstatus und folgende Struktur (gemessen):

{
  "error": {
    "code": null,
    "message": "The model 'gpt-image-2' does not support quality 'xhigh'.",
    "param": null,
    "request_id": "fbe4f24c-779d-41a0-8b3a-c62886cdd1ae",
    "type": "image_generation_user_error"
  }
}

code kann null sein. Werten Sie den HTTP-Status und message aus.

Geben Sie bei Anfragen an den Support die request_id aus der Antwort und die Fehlerinformationen (HTTP-Status und error.message) an. Wir empfehlen, diese Werte zu protokollieren.

Erweitert: Anbieter festlegen

Optional und in der Regel nicht nötig. Alle drei GPT-Image-Modelle (gpt-image-2.5-flare, gpt-image-2.5-sunburst, gpt-image-2) werden sowohl von azure_foundry als auch von openai bereitgestellt, jeweils für Generierung und Bearbeitung. Ohne Festlegung leitet das Gateway automatisch weiter.

Wenn Sie Anforderungen an die Inhaltsmoderation haben, können Sie einen Anbieter festlegen. Anfragen gehen dann nur an diesen Anbieter; ist er nicht verfügbar, wird nicht automatisch auf einen anderen Anbieter ausgewichen.

Die Angabe eines Anbieters, der das Modell nicht bereitstellt, liefert 400 provider_type_unavailable.

Text zu Bild /v1/images/generations

JSON-Request-Body: Sowohl das Body-Feld extra_body.provider.type als auch der Header X-OfoxAI-Provider-Type funktionieren.

resp = client.images.generate(
    model="openai/gpt-image-2",
    prompt="A simple red apple on a white table",
    size="1024x1024",
    extra_body={"extra_body": {"provider": {"type": "openai"}}},
)

const resp = await client.images.generate({
  model: 'openai/gpt-image-2',
  prompt: 'A simple red apple on a white table',
  size: '1024x1024',
  extra_body: { provider: { type: 'openai' } },
})

curl https://api.ofox.ai/v1/images/generations \
  -H "Authorization: Bearer $OFOX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "openai/gpt-image-2",
    "prompt": "...",
    "n": 1,
    "size": "1024x1024",
    "extra_body": { "provider": { "type": "openai" } }
  }'

Bild zu Bild /v1/images/edits

Ein Multipart-Upload hat keinen JSON-Body, in den sich extra_body verschachteln ließe; hier funktioniert daher nur der Header.

curl https://api.ofox.ai/v1/images/edits \
  -H "Authorization: Bearer $OFOX_API_KEY" \
  -H "X-OfoxAI-Provider-Type: openai" \
  -F "model=openai/gpt-image-2" \
  -F "prompt=..." \
  -F "image=@input.png"

Mit den SDKs: In Python übergeben Sie extra_headers={"X-OfoxAI-Provider-Type": "openai"}; in TypeScript übergeben Sie { headers: { 'X-OfoxAI-Provider-Type': 'openai' } } als zweites Argument.

Vollständige Referenz: API · Provider-Routing.

Offizielle Dokumentation und weitere Seiten

Die offizielle Dokumentation beschreibt das Verhalten bei direktem Aufruf von OpenAI. Weicht sie von den gemessenen Ergebnissen bei OfoxAI ab, gelten die gemessenen Ergebnisse auf dieser Website.

OpenAI

• Leitfaden zur Bildgenerierung · Bilder generieren 
• Leitfaden zur Bildgenerierung · Bilder bearbeiten 
• Leitfaden zur Bildgenerierung · Mit Maske lokal bearbeiten 
• Leitfaden zur Bildgenerierung · Größe und Qualität 
• Leitfaden zur Bildgenerierung · Kostenberechnung 
• Referenz der Images API 

OfoxAI-Seiten der Reihen

• Überblick über die Reihe GPT Image: Modellwahl, Größe, Qualität, Latenz, Fehler
• Text zu Bild
• Bearbeiten und mehrere Bilder
• Inpainting
• Reihe Nano Banana (Gemini Image) und Fehlerbehebung
• Reihe Seedream
• Reihe Qwen-Image
• Reihe MAI Image