OpenRouter：Announcements（RSS）

精选

AI 编辑部评分，满分 100

OpenRouter推出统一图像API

2026-06-23 08:00· 54天前· Brian Thomas

AI 导读

OpenRouter推出统一图像API，整合Google、OpenAI、Black Forest Labs、Recraft、ByteDance、Sourceful、Microsoft、xAI等30+模型。新API提供标准化请求格式，通过/api/v1/images/models端点返回每个模型的分辨率、宽高比、输出数量、输入参考图数量、种子等能力描述；通过/api/v1/images/models/{id}/endpoints端点获取具体服务商的定价与参数支持（如Seedream 4.5每张$0.04、FLUX.2 Pro每百万像素$0.03、GPT-5.4 Image 2按token计费）。OpenAI的GPT 5系列图像模型支持SSE流式预览，启用"stream": true即可边生成边返回预览。新图像模型将仅添加至专用API，建议现有用户切换。

推荐理由

OpenRouter 把 30+ 图像模型收进一个 API，参数自动发现和流式预览让频繁切换模型的开发者省去不少适配麻烦，尤其对 Agent 工作流很友好。

正文 · AI 翻译

OpenRouter 上的图像生成功能现已拥有专用 API，可统一访问 30 多个模型。

与我们所有的媒体生成 API 一样，我们标准化了接口以便轻松切换模型，允许透传以支持各模型的独特能力，并提供了编程方式来发现每个模型的详细信息。我们支持来自 Google、OpenAI、Black Forest Labs、Recraft、字节跳动、Sourceful、Microsoft 和 xAI 的模型，并且还在不断添加更多模型。

了解每个模型的能力

图像模型之间的差异会导致请求失败。Seedream 4.5 支持 18 种宽高比；Gemini 3.1 Flash Image 支持 14 种（有重叠，但不完全相同）。有些模型每次调用最多生成 10 张图像；其他模型则限制为 1 张。有些模型接受 16 个输入参考；其他模型只接受 4 个。

`/api/v1/images/models` 端点会为每个模型返回类型化的能力描述符：

{
  "id": "bytedance-seed/seedream-4.5",
  "supported_parameters": {
    "resolution": { "type": "enum", "values": ["1K", "2K", "4K"] },
    "aspect_ratio": { "type": "enum", "values": ["1:1", "16:9", "9:16", "..."] },
    "n": { "type": "range", "min": 1, "max": 10 },
    "input_references": { "type": "range", "min": 0, "max": 14 },
    "seed": { "type": "boolean" }
  },
  "supports_streaming": false
}

你的代码可以适配任何模型，无需硬编码不同提供商之间的差异，也不必因参数不被接受而苦苦应对 400 错误。

这对智能体尤其有用。将 `/api/v1/images/models` 的响应交给你的编程智能体，它便拥有了选择模型、验证输入以及生成图像所需的一切，无需反复试错。

按提供商细粒度划分

每个模型可能由多个提供商提供服务。每个端点的记录（`/api/v1/images/models/{id}/endpoints`）会为你提供每个提供商的准确信息：该特定端点接受哪些参数、允许哪些透传键、流式支持情况以及精细定价。

curl "https://openrouter.ai/api/v1/images/models/google/gemini-3.1-flash-image/endpoints"

每个端点还会返回一个包含精确计费结构的定价数组。不同的提供商采用不同的计费单位：

"pricing": [
  { "billable": "output_image", "unit": "image", "cost_usd": 0.04 }
]

Seedream 4.5 按每张图像固定收费 0.04 美元。FLUX.2 Pro 按每百万像素收费 0.03 美元（因此分辨率会影响成本）。GPT-5.4 Image 2 和 Gemini 3.1 Flash Image 按 token 计费。无需再猜测某次生成为何花费了特定费用；每个响应中的 usage 对象都包含以美元计价的精确成本。

一种请求格式，适配任何模型

该 API 将碎片化的图像生成世界统一为一种模式：

curl -X POST "https://openrouter.ai/api/v1/images" \
  -H "Authorization: Bearer $OPENROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "bytedance-seed/seedream-4.5",
    "prompt": "a red panda astronaut floating in space, studio lighting",
    "resolution": "2K",
    "aspect_ratio": "16:9"
  }'

分辨率、宽高比、质量、输出格式、背景透明度、输入参考图像、流式输出：所有参数在所有供应商之间均已实现标准化。当您需要使用特定供应商的功能（例如 Black Forest Labs 的 steps 或 guidance 参数）时，请通过 `provider.options` 传递这些参数，并使用 endpoints API 中的供应商标识符作为键名。

GPT 图像模型的流式预览

OpenAI 的 GPT 图像模型（GPT-5 Image、GPT-5 Image Mini、GPT-5.4 Image 2）通过 Image API 支持原生 SSE 流式输出。设置 `"stream": true` 后，您将在图像渲染过程中收到部分预览，从而让用户看到生成进度，无需等待完整生成结果。请查看任意端点的 `supports_streaming` 字段以确认该功能是否可用。

常见问题

通过聊天补全接口生成的图像会怎样？

此前，我们通过 completions 和 responses 接口支持图像生成。所有现有的图像模型在此路径下仍将继续获得支持，但新的图像模型将仅添加到专用的 Image API 中。

如果您正在使用 `openai/gpt-5-image`、`openai/gpt-5-image-mini` 或 `openai/gpt-5.4-image-2`，我们建议您切换到专用的图像模型。GPT 5 和 5.4 版本是通过大语言模型生成图像的，因此它们无法访问全部支持的参数，并且可能会产生额外的推理成本。

我可以使用特定供应商的功能吗？

可以。每个端点都会公开一个 `allowed_passthrough_parameters` 列表。请将特定供应商的参数键值对放在 `provider.options` 下，并使用供应商标识符作为键名。endpoints API 会明确告知您哪些键是被接受的。

定价是如何运作的？

每个端点都会返回精细化的定价明细，包含计费单位、美元成本以及可选的变体层级（例如基于分辨率的定价）。每次响应的 `usage` 对象中都包含精确的成本信息。

请通过 Discord 的 #feedback 频道告诉我们您的想法以及您希望接下来支持哪些模型。

智能体产品更新图像生成多模态

来源：OpenRouter：Announcements（RSS） · openrouter.ai

导出 Markdown

事件后续 · 1查看事件全部 →

同事件OpenRouter 推出统一图像 API 聚合多模型X：OpenRouter (@OpenRouter)· 6月24日