GetRouter文档
  • 简体中文

    • 图片

    GetRouter 为图片生成和图片编辑提供独立接口：

    POST https://getrouter.ai/v1/images/generations
POST https://getrouter.ai/v1/images/edits

    请从模型页面选择图片模型，并在发送请求前确认价格和支持的参数。

    生成图片

    curl https://getrouter.ai/v1/images/generations \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "MODEL_ID",
    "prompt": "一幅极简黑白风格的 API 路由器插画",
    "n": 1,
    "size": "1024x1024",
    "response_format": "url"
  }'

    响应包含 data 数组。根据模型和请求配置，每个项目可能返回图片 URL 或 Base64 图片数据。

    Python

    from openai import OpenAI

client = OpenAI(
    api_key="YOUR_API_KEY",
    base_url="https://getrouter.ai/v1",
)

response = client.images.generate(
    model="MODEL_ID",
    prompt="一幅极简黑白风格的 API 路由器插画",
    size="1024x1024",
    n=1,
)

print(response.data[0].url or response.data[0].b64_json)

    编辑图片

    图片编辑使用 Multipart Form Data：

    curl https://getrouter.ai/v1/images/edits \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "model=MODEL_ID" \
  -F "prompt=将背景替换为干净的摄影棚墙面" \
  -F "[email protected]" \
  -F "n=1"

    兼容模型还可能接受 Mask 和其他模型专用字段。

    常用字段

    字段用途
    model图片模型 ID
    prompt图片描述或编辑指令
    n请求生成的图片数量
    size模型支持的输出尺寸
    quality模型专用质量模式
    style模型专用风格模式
    response_format常用值包括 url 和 b64_json

    部分模型还支持服务商专用的图片请求格式。如果模型要求不同的 Body 结构，请使用 接口参考中的 Schema 和示例。

    Warning

    图片数量、尺寸、质量和编辑能力因模型而异，并会直接影响费用。批量生成前请查看价格页面。

    安全处理输出

    • 在托管 URL 过期前下载文件。
    • 将 b64_json 解码后再写入文件。
    • 应用对外提供生成文件时，请验证输出 MIME 类型。
    • 如果请求已成功，仅客户端保存失败，不要直接重新生成。

    下一步