Перейти к основному содержанию
OrcaRouter предоставляет генерацию изображений двумя путями в зависимости от выбранной модели:
  1. /v1/images/generations — формат OpenAI image API. Лучше всего подходит для специализированных моделей генерации изображений (семейство замены DALL-E, Imagen, Grok Imagine).
  2. /v1/chat/completions — генерация изображений в стиле чата. Лучше всего подходит, когда нужна модель, возвращающая текст и изображение за один шаг (семейство Gemini nano-banana / «imagine»).

​
Путь 1: специализированный image API

/v1/images/generations следует формату OpenAI image API. Семейства моделей, обслуживающих этот эндпоинт:
  • 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"
  }'

​
Путь 2: генерация изображений через chat completions

Некоторые модели Gemini могут возвращать изображение в составе обычного шага chat completion. Когда вы выбираете одну из этих моделей, OrcaRouter автоматически сообщает апстриму, что в ответе должны быть и текст, и изображение:
  • google/gemini-2.5-flash-image
  • google/gemini-3-pro-image-preview
  • google/gemini-3.1-flash-image-preview

​
Пример

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.
Эти модели нельзя вызвать через /v1/images/generations — используйте для них chat completions.

​
См. также