OpenRouter 平台功能

OpenRouter 平台功能

图像生成（服务端）

3 分钟阅读

图像生成（Image Generation）

用任意模型根据文本提示词生成图像

Beta

测试版（Beta）

服务端工具目前处于测试阶段。API 与行为可能会变更。

openrouter:image_generation 服务端工具让任意模型都能根据文本提示词生成图像。当模型判断需要创建图像时，会带着描述调用该工具。OpenRouter 执行图像生成，并将结果返回给模型。

工作原理

  1. 在 tools 数组中加入 { "type": "openrouter:image_generation" }。
  2. 模型根据用户请求决定是否需要生成图像，并撰写提示词。
  3. OpenRouter 使用配置的模型生成图像（默认为 openai/gpt-5-image）。
  4. 生成的图像 URL 返回给模型。
  5. 模型将图像纳入回复。如有需要，它可能在同一次请求中生成多张图像。

快速开始

const response = await fetch('https://openrouter.ai/api/v1/chat/completions', {
  method: 'POST',
  headers: {
    Authorization: 'Bearer <OPENROUTER_API_KEY>',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    model: 'openai/gpt-5.2',
    messages: [
      {
        role: 'user',
        content: '生成一张日落时分的未来城市图片'
      }
    ],
    tools: [
      { type: 'openrouter:image_generation' }
    ]
  }),
});

const data = await response.json();
console.log(data.choices[0].message.content);

配置

图像生成工具接受可选的 parameters，用于自定义输出：

{
  "type": "openrouter:image_generation",
  "parameters": {
    "model": "openai/gpt-5-image",
    "quality": "high",
    "aspect_ratio": "16:9",
    "size": "1024x1024",
    "background": "transparent",
    "output_format": "png"
  }
}
参数类型默认值说明
modelstringopenai/gpt-5-image使用哪一个图像生成模型。参见可用图像模型。
qualitystring—图像质量级别（取决于模型，例如 "low"、"medium"、"high"）
sizestring—图像尺寸（例如 "1024x1024"、"512x512"）
aspect_ratiostring—宽高比（例如 "16:9"、"1:1"、"4:3"）
backgroundstring—背景样式（例如 "transparent"、"opaque"）
output_formatstring—输出格式（例如 "png"、"jpeg"、"webp"）
output_compressionnumber—有损格式的压缩级别（0-100）
moderationstring—内容审核级别（例如 "auto"、"low"）

除 model 外，所有参数都会直接传递给底层图像生成 API。可用选项取决于所使用的具体模型。

响应

模型调用图像生成工具时，会收到类似如下的响应：

{
  "status": "ok",
  "imageUrl": "https://..."
}

若生成失败，响应会包含错误信息：

{
  "status": "error",
  "error": "Generation failed due to content policy"
}

也可用于 Responses API

图像生成服务端工具也可用于 Responses API：

const response = await fetch('https://openrouter.ai/api/v1/responses', {
  method: 'POST',
  headers: {
    Authorization: 'Bearer <OPENROUTER_API_KEY>',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    model: 'openai/gpt-5.2',
    input: '生成一张山地风景图',
    tools: [
      {
        type: 'openrouter:image_generation',
        parameters: { quality: 'high' }
      }
    ]
  }),
});

const data = await response.json();
console.log(data);

定价

图像生成定价取决于所使用的底层模型：

该费用叠加在处理请求和响应所产生的标准 LLM Token 费用之上。

后续步骤

上一页Datetime下一页 Apply Patch