图片生成与编辑

Relyven 同时提供 OpenAI Images 兼容接口和 Gemini 原生兼容接口。直接图片接口与 Responses 中的 image_generation 工具使用不同的调用方式。

能力简介

模型	常用别称	适合任务	尺寸与输出
gpt-image-2	—	文生图、局部编辑、蒙版编辑、多图合成	n=1–10；支持任意合规尺寸、单边最高 3840；PNG/JPEG
gemini-2.5-flash-image	Nano Banana	快速文生图、参考图编辑	默认约 1K；响应同时包含文本和图片
gemini-3-pro-image	Nano Banana Pro	高质量生成与编辑、复杂文字和构图	10 种画幅；1K、2K、4K
gemini-3.1-flash-image	Nano Banana 2	更快的生成与编辑、质量与速度平衡	10 种画幅；512、1K、2K、4K
doubao-seedream-5-0-pro-260628	—	文生图、单参考图编辑、多参考图融合	最多 10 张参考图；每次输出 1 张，n=1

别称仅用于识别模型，不是可调用的模型 ID。请求必须使用表中的完整模型名。

OpenAI Images 接口

gpt-image-2 与 Seedream 使用 POST /v1/images/generations。下面示例会让 gpt-image-2 返回两张 1024×640 图片：

curl https://api.relyven.com/v1/images/generations \
  -H "Authorization: Bearer $RELYVEN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2",
    "prompt": "A clean product illustration of an API gateway",
    "size": "1024x640",
    "quality": "low",
    "n": 2,
    "output_format": "png"
  }'

gpt-image-2 的宽和高必须是 16 的倍数，单边不超过 3840，宽高比不超过 3:1，总像素为 655,360–8,294,400。局部编辑、蒙版和多图合成使用 POST /v1/images/edits，重复提交 image[] 可传多张参考图。

Gemini 图片接口

Nano Banana 系列使用 Gemini 原生请求体。将 URL 中的模型名替换为表中任一 Gemini 模型；编辑任务在 parts 中同时传提示词和 inlineData 或 fileData 图片。

curl https://api.relyven.com/v1beta/models/gemini-3.1-flash-image:generateContent \
  -H "x-goog-api-key: $RELYVEN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "contents": [{"role": "user", "parts": [{"text": "A clean product illustration of an API gateway"}]}],
    "generationConfig": {
      "responseModalities": ["TEXT", "IMAGE"],
      "imageConfig": {"aspectRatio": "16:9", "imageSize": "2K"}
    }
  }'

Pro 与 3.1 Flash 支持 1:1、2:3、3:2、3:4、4:3、4:5、5:4、9:16、16:9、21:9。只有 3.1 Flash 额外支持 imageSize: "512"。

Seedream 参考图

Seedream 的编辑和多图融合仍使用生成端点。image 可以是一条 URL/Data URL，也可以是最多 10 张参考图的数组：

{
  "model": "doubao-seedream-5-0-pro-260628",
  "prompt": "保留第一张图的主体，使用第二张图的视觉风格。",
  "image": [
    "https://example.com/subject.png",
    "https://example.com/style.png"
  ],
  "size": "1024x1024",
  "n": 1
}

OpenAI 兼容客户端也可以通过 /v1/images/edits 上传 Seedream 或 gpt-image-2 参考图：

curl https://api.relyven.com/v1/images/edits \
  -H "Authorization: Bearer $RELYVEN_API_KEY" \
  -F "model=doubao-seedream-5-0-pro-260628" \
  -F "prompt=将背景替换为中性影棚背景" \
  -F "image=@./input.png" \
  -F "n=1"

Seedream 的第一张参考图包含在基础价格内；每增加一张参考图，加收基础图片价格的 1/15。输出不超过 236 万像素使用低档，超过后使用模型广场展示的高档价格。

返回与重试

结果位于 data 数组，可能是 URL 或 Base64。客户端应验证实际数量、文件签名、尺寸和请求日志；临时 URL 可能过期。付费图片请求发生网络超时后，先按请求 ID 和用量日志确认结果，不要直接重复提交。

官方参考：OpenAI 图片生成指南