ImageRouter 图像生成

使用 curl 命令，调用 ImageRouter 上任意可用模型生成图像。

可用模型

test/test 模型是一个免费的测试用占位模型，仅用于 API 功能验证。它并非真实可用的生成模型，因此请在实际图像生成任务中选用其他模型。

获取最受欢迎的前 10 个模型：

curl -X POST 'https://backend.imagerouter.io/operations/get-popular-models'

按名称搜索可用模型：

curl "https://api.imagerouter.io/v1/models?type=image&sort=date&name=gemini"

获取全部可用模型（最多 1000 个）：

curl "https://api.imagerouter.io/v1/models?type=image&sort=date&limit=1000"

快速开始 — 文生图（Text-to-Image）

通过 JSON 接口进行基础图像生成：

curl 'https://api.imagerouter.io/v1/openai/images/generations' 
  -H 'Authorization: Bearer YOUR_API_KEY' 
  --json '{
    "prompt": "a serene mountain landscape at sunset",
    "model": "test/test",
    "quality": "auto",
    "size": "auto",
    "response_format": "url",
    "output_format": "webp"
  }'

统一接口（支持文生图与图生图）

文生图（multipart/form-data 方式）：

curl 'https://api.imagerouter.io/v1/openai/images/edits' 
  -H 'Authorization: Bearer YOUR_API_KEY' 
  -F 'prompt=a cyberpunk city at night' 
  -F 'model=test/test' 
  -F 'quality=high' 
  -F 'size=1024x1024' 
  -F 'response_format=url' 
  -F 'output_format=webp'

图生图（需提供输入图像）：

curl 'https://api.imagerouter.io/v1/openai/images/edits' 
  -H 'Authorization: Bearer YOUR_API_KEY' 
  -F 'prompt=transform this into a watercolor painting' 
  -F 'model=test/test' 
  -F 'quality=auto' 
  -F 'size=auto' 
  -F 'response_format=url' 
  -F 'output_format=webp' 
  -F 'image[]=@/path/to/your/image.webp'

多图输入（最多支持 16 张）：

curl 'https://api.imagerouter.io/v1/openai/images/edits' 
  -H 'Authorization: Bearer YOUR_API_KEY' 
  -F 'prompt=combine these images' 
  -F 'model=test/test' 
  -F 'image[]=@image1.webp' 
  -F 'image[]=@image2.webp' 
  -F 'image[]=@image3.webp'

带掩码编辑（部分模型在内补绘制（inpainting）时需提供掩码）：

curl 'https://api.imagerouter.io/v1/openai/images/edits' 
  -H 'Authorization: Bearer YOUR_API_KEY' 
  -F 'prompt=fill the masked area with flowers' 
  -F 'model=test/test' 
  -F 'image[]=@original.webp' 
  -F 'mask[]=@mask.webp'

参数说明

• model（必需）：指定使用的图像模型（参见 https://imagerouter.io/models）
• prompt（可选）：生成所用的文本描述。大多数模型需要 prompt，但并非全部支持
• quality（可选）：auto（默认）、low、medium、high
• size（可选）：auto（默认），或指定为 WIDTHxHEIGHT 格式（例如：1024x1024）
• response_format（可选）：
  • url（默认）—— 返回托管图像的 URL 地址
  • b64_json—— 返回 base64 编码的图像数据
  • b64_ephemeral—— 返回不记录到日志中的 base64 编码图像
• output_format（可选）：webp（默认）、jpeg、png
• image[]（可选）：图生图所需的输入图像文件（仅 multipart/form-data 方式支持）
• mask[]（可选）：用于内补绘制（inpainting）的编辑掩码（仅 multipart/form-data 方式支持）

响应格式

{
  "created": 1769286389027,
  "data": [
    {
      "url": "https://storage.imagerouter.io/fffb4426-efbd-4bcc-87d5-47e6936bf0bb.webp"
    }
  ],
  "latency": 6942,
  "cost": 0.004
}

接口功能对比

使用提示

• /v1/openai/images/generations 与 /v1/openai/images/edits 在统一接口下功能一致
• 若无需上传文件，仅需简单文生图，请优先使用 JSON 接口
• 若需图生图等高级编辑能力，请使用统一接口（/edits）
• 请查阅 https://imagerouter.io/models 获取各模型具体特性支持情况（如 quality 参数支持、edit 功能支持等）
• 您的 API Key 可在 https://imagerouter.io/api-keys 获取

按使用场景划分的示例

快速测试生成：

curl 'https://api.imagerouter.io/v1/openai/images/generations' 
  -H 'Authorization: Bearer YOUR_API_KEY' 
  --json '{"prompt":"test image","model":"test/test"}'

直接下载生成图像：

curl 'https://api.imagerouter.io/v1/openai/images/generations' 
  -H 'Authorization: Bearer YOUR_API_KEY' 
  --json '{"prompt":"abstract art","model":"test/test"}' 
  | jq -r '.data[0].url' 
  | xargs curl -o output.webp