메인 콘텐츠로 건너뛰기
OrcaRouter는 선택한 모델에 따라 두 가지 경로로 이미지 생성을 노출합니다:
  1. /v1/images/generations — OpenAI 이미지 API 형태. 전용 이미지 생성 모델(DALL-E 대체 패밀리, Imagen, Grok Imagine)에 가장 적합.
  2. /v1/chat/completions — 채팅 스타일 이미지 생성. 한 턴에 텍스트와 이미지를 반환하는 모델(Gemini의 nano-banana / “imagine” 패밀리)에 가장 적합.

​
경로 1: 전용 이미지 API

/v1/images/generations는 OpenAI 이미지 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는 SDK의 직렬화에 따라 텍스트 +
# 이미지 data URL 또는 inline_data 블록을 가집니다. SDK가 이미지를
# 직접 노출하지 않으면 원시 응답을 확인하세요.
이러한 모델은 /v1/images/generations로 호출할 수 없습니다 — chat completions를 사용하세요.

​
관련 항목