Zum Hauptinhalt springen
OrcaRouter stellt Bildgenerierung über zwei Pfade bereit, je nachdem, welches Modell du wählst:
  1. /v1/images/generations — OpenAI-Bild-API-Form. Am besten für dedizierte Bildgenerierungsmodelle (DALL-E-Ersatzfamilie, Imagen, Grok Imagine).
  2. /v1/chat/completions — Bildgenerierung im Chat-Stil. Am besten, wenn du ein Modell möchtest, das Text und ein Bild in einer Runde zurückgibt (Gemini nano-banana / “imagine”-Familie).

Pfad 1: dedizierte Bild-API

/v1/images/generations folgt der OpenAI-Bild-API-Form. Modellfamilien, die diesen Endpunkt bedienen:
  • OpenAI: openai/gpt-image-1, openai/gpt-image-1-mini, openai/gpt-image-1.5
  • Google Imagen: google/imagen-4.0-fast-generate-001, google/imagen-4.0-generate-001, google/imagen-4.0-ultra-generate-001
  • xAI: grok/grok-imagine-image, grok/grok-imagine-image-pro
curl https://api.orcarouter.ai/v1/images/generations \
  -H "Authorization: Bearer sk-orca-..." \
  -H "Content-Type: application/json" \
  -d '{
    "model": "openai/gpt-image-1",
    "prompt": "A cat astronaut on Mars, photorealistic",
    "size": "1024x1024"
  }'

Pfad 2: Bildgenerierung über Chat Completions

Einige Gemini-Modelle können ein Bild als Teil einer normalen Chat-Completion-Runde zurückgeben. Wenn du eines dieser Modelle wählst, sagt OrcaRouter dem Upstream automatisch, dass er sowohl Text als auch ein Bild in der Antwort emittieren soll:
  • google/gemini-2.5-flash-image
  • google/gemini-3-pro-image-preview
  • google/gemini-3.1-flash-image-preview

Beispiel

from openai import OpenAI

client = OpenAI(base_url="https://api.orcarouter.ai/v1", api_key="sk-orca-...")

resp = client.chat.completions.create(
    model="google/gemini-2.5-flash-image",
    messages=[{"role": "user", "content": "Draw a watercolour of a foggy harbor at dawn."}],
)

# resp.choices[0].message.content enthält Text + eine Bild-Data-URL
# oder einen inline_data-Block, abhängig von der Serialisierung der
# SDK. Inspiziere die rohe Antwort, wenn deine SDK das Bild nicht
# direkt offenlegt.
Diese Modelle sind nicht über /v1/images/generations aufrufbar — verwende Chat Completions für sie.

Siehe auch