Przejdź do głównej treści
OrcaRouter udostępnia generowanie obrazów dwiema ścieżkami, zależnie od wybranego modelu:
  1. /v1/images/generations — kształt API obrazów OpenAI. Najlepsze dla dedykowanych modeli generowania obrazów (rodzina zastępująca DALL-E, Imagen, Grok Imagine).
  2. /v1/chat/completions — generowanie obrazów w stylu chatu. Najlepsze, gdy chcesz, by model zwrócił tekst i obraz w jednej turze (rodzina nano-banana / “imagine” Gemini).

Ścieżka 1: dedykowane API obrazów

/v1/images/generations podąża za kształtem API obrazów OpenAI. Rodziny modeli obsługujące ten endpoint:
  • 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"
  }'

Ścieżka 2: generowanie obrazów przez chat completions

Niektóre modele Gemini mogą zwrócić obraz jako część zwykłej tury chat completion. Gdy wybierzesz jeden z tych modeli, OrcaRouter automatycznie mówi upstreamowi, by wyemitował zarówno tekst, jak i obraz w odpowiedzi:
  • google/gemini-2.5-flash-image
  • google/gemini-3-pro-image-preview
  • google/gemini-3.1-flash-image-preview

Przykład

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 niesie tekst + data URL obrazu lub
# blok inline_data, zależnie od serializacji SDK. Sprawdź surową
# odpowiedź, jeśli Twój SDK nie wystawia obrazu bezpośrednio.
Te modele nie są dostępne przez /v1/images/generations — użyj dla nich chat completions.

Zobacz także