Vai al contenuto principale
OrcaRouter espone la generazione di immagini attraverso due percorsi, a seconda del modello che scegli:
  1. /v1/images/generations — forma dell’API immagini di OpenAI. Ideale per modelli dedicati alla generazione di immagini (famiglia sostitutiva di DALL-E, Imagen, Grok Imagine).
  2. /v1/chat/completions — generazione di immagini in stile chat. Ideale quando vuoi un modello che restituisca testo e un’immagine in un singolo turno (famiglia nano-banana / “imagine” di Gemini).

​
Percorso 1: API immagini dedicata

/v1/images/generations segue la forma dell’API immagini di OpenAI. Le famiglie di modelli che servono questo 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"
  }'

​
Percorso 2: generazione di immagini tramite chat completions

Alcuni modelli Gemini possono restituire un’immagine come parte di un normale turno di chat completion. Quando scegli uno di questi modelli, OrcaRouter indica automaticamente all’upstream di emettere sia testo che un’immagine nella risposta:
  • google/gemini-2.5-flash-image
  • google/gemini-3-pro-image-preview
  • google/gemini-3.1-flash-image-preview

​
Esempio

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 carries text + an image data URL or
# inline_data block, depending on the SDK's serialization. Inspect the
# raw response if your SDK doesn't surface the image directly.
Questi modelli non sono richiamabili tramite /v1/images/generations — usa chat completions per loro.

​
Vedi anche