跳转到主要内容
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 对话的一部分返回。 当你选中这些模型时，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 会包含文字 + 图像 data URL 或
# inline_data 块，具体形态取决于 SDK 的序列化方式。如果你的 SDK
# 不直接透出图像，请检查原始响应。
这些模型不能通过 /v1/images/generations 调用——它们必须走 chat completions。

​
另见