如何使用 OpenAI GPT Image 2.5 Sunburst 图像编辑 API:图生图接入指南(2026)

2 min · 更新于 2026-07-11 · NamiFusion 团队

OpenAI GPT Image 2.5 Sunburst 图像编辑 API 接入教程:参数说明、价格与可直接运行的调用代码,先在 Playground 试玩再一行代码接入。

OpenAI GPT Image 2.5 Sunburst 图像编辑 是一款图生图模型(由 OpenAI 提供):使用最多 16 张参考图片完成高保真、精确的图像编辑。在 NamiFusion 上可以在 Playground 直接试玩(提交前显示准确报价),再通过统一 REST API 一行代码接入,典型一次调用约 $0.220。

TL;DR

· 任务类型:图生图,由 OpenAI 提供

· 价格:典型一次调用约 $0.220($1 = 100 积分),按量计费无订阅

· 上手路径:Playground 试玩(提交前显示报价)→ API Keys 建密钥 → 一个 POST 接入

· 可调参数:12 个(见下方参数表)

· 无平台水印,商用可用(遵守服务条款)

用 OpenAI GPT Image 2.5 Sunburst 图像编辑 能做什么?

社媒配图与封面:按帖子主题批量出图,统一风格后直接排期发布。

电商与广告素材:产品场景图、Banner 底图、A/B 测试的多版本视觉。

概念设计与灵感探索:角色、场景、风格板,用低成本快速迭代方向。

内容工作流串联:生成结果可直接作为图生视频或换脸的输入素材。

怎么调用这个 API?

  1. 在 NamiFusion 注册并在 API Keys 页面创建密钥(注册赠送积分仅可用于指定模型)。
  2. 用下面的 cURL 示例提交任务,Header 带上 Bearer 密钥。
  3. 用返回的 task_uuid 轮询任务状态,完成后取输出 URL。
提交任务
# 1) Submit — returns { "task_uuid": "..." }
curl -X POST "https://www.namifusion.com/api/v1/marketplace/run/openai/gpt-image-2.5-sunburst/edit" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "input": {
    "images": [
      "https://d1s3annbwribom.cloudfront.net/marketplace/examples/2026/08/19/b58b3f934797.jpeg"
    ],
    "prompt": "A futuristic cityscape at sunset, with glowing skyscrapers and flying cars.",
    "n": 1,
    "aspect_ratio": "1:1",
    "resolution": "1k",
    "quality": "auto",
    "background": "auto",
    "input_fidelity": "low",
    "output_format": "png",
    "moderation": "auto"
  }
}'

# 2) Poll until status is "completed", then read the output URLs
curl "https://www.namifusion.com/api/v1/marketplace/run/tasks/TASK_UUID" \
  -H "Authorization: Bearer YOUR_API_KEY"

有哪些参数?

images(图片):必填

prompt(提示词):必填

n(生成数量):可选,默认 1

aspect_ratio(宽高比):可选,默认 "1:1"

resolution(分辨率):可选,默认 "1k"

size(具体尺寸):可选

quality(渲染质量):可选,默认 "auto"

mask(蒙版图片):可选

background(背景模式):可选,默认 "auto"

input_fidelity(输入忠实度):可选,默认 "low"

output_format(图片格式):可选,默认 "png"

output_compression(压缩级别):可选

OpenAI GPT Image 2.5 Sunburst 图像编辑 的提示词怎么写?

  1. 主体在前:先写画面主角与动作,再补环境、光线、风格("一名宇航员在雨中的霓虹街头奔跑,电影感,浅景深")。
  2. 用具体名词代替形容词堆砌:"85mm 人像镜头、黄昏逆光" 比 "非常好看、超高质量" 有效得多。
  3. 迭代时只改一个变量:固定 seed 复现结果,每次只调整一个描述词,才能知道是什么在起作用。
  4. 负面信息放正面写:与其说"不要模糊",不如直接要"锐利对焦、清晰细节"。

价格是多少?

按次积分计价,典型一次调用约 $0.220($1 = 100 积分),实际价格随参数(分辨率/时长等)变化,Playground 里提交前会显示准确报价。

OpenAI GPT Image 2.5 Sunburst 图像编辑

使用最多 16 张参考图片完成高保真、精确的图像编辑。

API 接口

POST /api/v1/marketplace/run/openai/gpt-image-2.5-sunburst/edit

请求体格式为 {"input": {...}}。提交后轮询 GET /api/v1/marketplace/run/tasks/{task_uuid},直到任务完成。

参数

  • images(必填):1 至 16 个输入图片 URL。
  • prompt(必填):图像编辑指令,最多 5,000 个字符。
  • mask:可选蒙版图片 URL。
  • background:auto、transparent 或 opaque。
  • input_fidelity:low 或 high。
  • n:生成 1 至 10 张图片,默认 1。
  • aspect_ratio:支持 1:1、1:2、2:1、1:3、3:1、2:3、3:2、3:4、4:3、4:5、5:4、9:16、16:9、9:21、21:9。
  • resolution:1k、2k 或 4k,默认 1k。
  • size:可选的 宽x高 明确尺寸;指定后覆盖 aspect_ratio 和 resolution。
  • quality:auto、low、medium、high、xhigh 或 max,默认 auto。
  • output_format:png、jpeg 或 webp,默认 png。
  • output_compression:0 至 100,仅压缩格式生效。
  • moderation:auto 或 low,默认 auto。

输出

{"images": ["https://..."]}

常见问题

可以先免费试用吗?+

注册赠送积分仅可用于指定模型,适用范围会持续更新;Playground 提交前会显示准确报价。

生成内容可以商用吗?有水印吗?+

可以商用,NamiFusion 不给生成结果加平台水印;使用须遵守服务条款与适用法律。

内容政策是什么?+

色情内容、涉及未成年人的性化内容、未经授权使用真人、欺骗性冒充、诈骗与虚假代言均禁止。合法、自愿且非露骨的成年人主题可能被允许,详见服务条款。

OpenAI GPT Image 2.5 Sunburst 图像编辑 的任务要跑多久?+

取决于参数,图像通常数秒到数十秒,视频通常数十秒到几分钟;API 返回 task_uuid 供轮询。

分辨率/时长上限是多少?+

以模型参数表为准:每个模型的可选分辨率、时长档位都在上方参数说明与 Playground 中列出。