SUPER-RESOLUTION IMAGE

超分生图

使用 GPT 和 Gemini 超分生图分组生成 1K、2K、4K 图片，包含协议、模型、质量路由和调用示例。

RootFlowAI 的超分生图分组提供 1K、2K、4K 输出，适合需要更大成品尺寸、更多可见细节或后续排版裁切的场景。该分组使用生成式超分或固定内部画布扩展到目标像素，不宣传为原生 2K/4K 采样。

创建 API Key 时选择对应分组：

GPT 模型选择 GPT 超分生图
Gemini 模型选择 Gemini 超分生图

两个分组协议完全独立。GPT 使用 OpenAI Images API；Gemini 使用原生 generateContent API，不能混用请求格式。

可用模型

分组	对外模型	协议	输出档位
GPT 超分生图	`gpt-image-2-superres`	OpenAI Images	1K / 2K / 4K
Gemini 超分生图	`gemini-3-pro-image-preview-superres`	Gemini `generateContent`	1K / 2K / 4K
Gemini 超分生图	`gemini-3.1-flash-image-preview-superres`	Gemini `generateContent`	1K / 2K / 4K

GPT 超分生图

质量参数

gpt-image-2-superres 为保证价格和输出策略一致，实际生成质量固定为 medium。接口仍兼容常见的 quality 参数，但传入值不会改变实际质量：

请求参数	实际质量	说明
不传 `quality`	medium	默认中等质量
`quality=high`	medium	保留参数兼容，实际仍为 medium
`quality=medium`	medium	中等质量生成
`quality=low`	medium	保留参数兼容，实际仍为 medium

其他 quality 值会直接返回 400，不会改走其他模型或其他渠道。传入的 quality 只用于接口兼容，不代表上游质量档位发生变化。

文生图

curl https://api.rootflowai.com/v1/images/generations \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-xxxxxxxxxxxxxxxx" \
  -d '{
    "model": "gpt-image-2-superres",
    "prompt": "高端腕表广告，黑色背景，金属机芯细节清晰，棚拍光线",
    "quality": "high",
    "size": "2048x2048",
    "n": 1
  }'

size 直接使用像素格式。常用示例：

档位	正方形示例	横图示例
1K	`1024x1024`	`1536x1024`
2K	`2048x2048`	`2048x1152`
4K	`2880x2880`	`3840x2160`

成功后返回 OpenAI Images 格式，图片会保存到 RootFlowAI 图床：

{
  "created": 1786437000,
  "data": [
    {
      "url": "https://img.rootflowai.com/f/image/example.png"
    }
  ],
  "usage": {
    "prompt_tokens": 100,
    "completion_tokens": 14272,
    "total_tokens": 14372
  }
}

图生图

本地参考图使用 /v1/images/edits 和 multipart/form-data：

curl https://api.rootflowai.com/v1/images/edits \
  -H "Authorization: Bearer sk-xxxxxxxxxxxxxxxx" \
  -F "model=gpt-image-2-superres" \
  -F "prompt=保留产品结构，把背景改成深色高级棚拍风格" \
  -F "quality=medium" \
  -F "size=2048x2048" \
  -F "image=@/path/to/reference.png;type=image/png"

Gemini 超分生图

Gemini 分组保留原生协议。模型名位于 URL 中，分辨率通过 generationConfig.imageConfig.imageSize 指定。

文生图

curl "https://api.rootflowai.com/v1beta/models/gemini-3-pro-image-preview-superres:generateContent" \
  -H "Content-Type: application/json" \
  -H "x-goog-api-key: sk-xxxxxxxxxxxxxxxx" \
  -d '{
    "contents": [
      {
        "role": "user",
        "parts": [
          { "text": "高端腕表广告，黑色背景，金属机芯细节清晰，棚拍光线" }
        ]
      }
    ],
    "generationConfig": {
      "responseModalities": ["TEXT", "IMAGE"],
      "imageConfig": {
        "aspectRatio": "1:1",
        "imageSize": "4K"
      }
    }
  }'

imageSize 支持 1K、2K、4K。常用比例包括 1:1、3:2、2:3、4:3、3:4、16:9、9:16；Flash 模型还支持 8:1、4:1、1:4、1:8 等长图比例。

Gemini 原生响应中的图片位于 candidates[].content.parts[].inlineData.data，内容是 base64。该分组不把响应转换为 OpenAI Images URL：

{
  "candidates": [
    {
      "content": {
        "role": "model",
        "parts": [
          {
            "inlineData": {
              "mimeType": "image/png",
              "data": "iVBORw0KGgoAAA..."
            }
          }
        ]
      },
      "finishReason": "STOP"
    }
  ],
  "usageMetadata": {
    "promptTokenCount": 202,
    "candidatesTokenCount": 2000,
    "totalTokenCount": 2202
  }
}

参考图

把参考图作为原生 inlineData part 与提示词一起发送。单次请求最多建议使用 14 张参考图：

{
  "contents": [
    {
      "role": "user",
      "parts": [
        { "text": "保持产品结构，只替换背景和灯光" },
        {
          "inlineData": {
            "mimeType": "image/png",
            "data": "BASE64_IMAGE_DATA"
          }
        }
      ]
    }
  ],
  "generationConfig": {
    "responseModalities": ["TEXT", "IMAGE"],
    "imageConfig": {
      "aspectRatio": "1:1",
      "imageSize": "2K"
    }
  }
}

超时与失败处理

1K/2K 通常需要几十秒，4K 可能需要数分钟，客户端完整请求超时建议设置为 900 秒。
生图请求可能已经进入上游队列。连接中断、网关超时或未知响应时，不要自动重试，以免产生重复任务和重复计费。
内容审核错误不会自动降级到旧渠道或其他模型。
Gemini Pro 4K 曾观察到临时不可用错误；业务侧应把失败明确返回给用户，不要静默切换模型。