<br /> 七牛云对象存储配置手册：用于图生图参考图 URL</p> <p>用途：<br /> 如果经常使用图生图功能，或者单张图片平均大于 3MB，建议先把图片上传到七牛云对象存储，再把图片 URL 填入 API 的 images / image 字段中。这样可以提高大图、多图请求的成功率和稳定性，减少 base64 体积膨胀导致的失败概率。</p> <p>推荐方案：<br /> 公开空间 + 自定义图片访问域名 + HTTPS + 随机文件名 + 生命周期 1～3 天自动删除。</p> <p>准备内容：<br /> 1. 七牛云账号并完成实名认证<br /> 2. 一个可用的二级域名，例如 img.example.com<br /> 3. 对象存储空间 Bucket<br /> 4. 自定义 CDN 加速域名或源站域名<br /> 5. HTTPS 证书<br /> 6. 图片上传后得到的公网 URL</p> <p>配置步骤：<br /> 1. 注册并实名认证七牛云账号。<br /> 2. 进入对象存储 Kodo，创建空间 Bucket。<br /> 3. 空间建议选择：公开空间、标准存储、离用户较近的存储区域。<br /> 4. 进入空间的域名管理，绑定自定义域名，例如 img.example.com。<br /> 5. 七牛云会提供 CNAME 地址，到你的域名服务商处添加 CNAME 解析。<br /> 6. CNAME 解析不能删除；它是图片域名正常访问的基础。<br /> 7. 配置 HTTPS 证书，确保可以通过 <a href="javascript:;" box-img="http://img.example.com/xxx.png" data-imgbox="imgbox" rel="nofollow">http://img.example.com/xxx.png</a> 访问图片。<br /> 8. 设置生命周期规则，例如 uploads/ 前缀下的临时图片 1～3 天后自动删除。<br /> 9. 上传图片，获得图片 URL。<br /> 10. 在 API 请求中使用图片 URL。</p> <p>/v1/api/generate 示例：<br /> {<br /> “model”: “gpt-image-2”,<br /> “prompt”: “请参考这张图片，生成一张风格相似但更精致的图片”,<br /> “images”: [<br /> “<a href="http://img.example.com/uploads/test.png&#8221" rel="nofollow">http://img.example.com/uploads/test.png&#8221</a>;<br /> ],<br /> “aspectRatio”: “1024×1024”,<br /> “replyType”: “async”<br /> }</p> <p>/v1/images/generations 示例：<br /> {<br /> “model”: “gpt-image-2”,<br /> “prompt”: “请参考这张图片，生成一张风格相似但更精致的图片”,<br /> “image”: [<br /> “<a href="http://img.example.com/uploads/test.png&#8221" rel="nofollow">http://img.example.com/uploads/test.png&#8221</a>;<br /> ],<br /> “size”: “1024×1024”,<br /> “response_format”: “url”<br /> }</p> <p>注意：<br /> – SecretKey 不要公开，不要写进前端网页源码。<br /> – 如果只是手动上传图片，普通用户不一定需要使用 AccessKey / SecretKey。<br /> – 如果要自动化上传图片，需要在后端生成上传凭证，不要在前端暴露 SecretKey。<br /> – 图片 URL 必须能公网访问。<br /> – 成本优先时，建议在 API 参考图中使用 http:// 图片链接，不建议使用 https:// 七牛云图片链接。<br /> – 如果你的七牛云图片域名已经开启 HTTPS，该域名下所有流量会按 HTTPS 协议价格计费，且 HTTPS 域名产生的用量不计入免费额度。<br /> – 不建议使用带中文、空格、特殊符号的文件名。<br /> – 建议使用随机长文件名，例如 uploads/2026/05/随机字符串.png。<br /> – 当前 API 请求体限制为 30MB，base64 会比原图更大，大图和多图优先使用图片 URL。<br /> – 七牛云对象存储每月有 10GB 标准存储免费额度，具体以七牛云官方最新说明为准。<br />

七牛云控制台
→ 对象存储 Kodo
→ 空间管理
→ 新建空间

img.example.com
image.example.com
cdn.example.com

对象存储 Kodo
→ 空间管理
→ 选择你的空间
→ 域名管理
→ 绑定自定义 CDN 加速域名

记录类型：CNAME
主机记录：img
记录值：七牛云提供的 CNAME 地址
线路类型：默认
TTL：默认

http://img.example.com/uploads/test.png

https://img.example.com/uploads/test.png

对象存储 Kodo
→ 空间管理
→ 选择你的空间
→ 空间设置
→ 生命周期
→ 新建规则

http://img.example.com/uploads/test.png

uploads/2026/05/随机字符串.png
uploads/temp/随机字符串.jpg
uploads/temp/随机字符串.webp

{
  "model": "gpt-image-2",
  "prompt": "请参考这张图片，生成一张风格相似但更精致的图片",
  "images": [
    "http://img.example.com/uploads/test.png"
  ],
  "aspectRatio": "1024x1024",
  "replyType": "async"
}

{
  "model": "gpt-image-2",
  "prompt": "请参考这张图片，生成一张风格相似但更精致的图片",
  "image": [
    "http://img.example.com/uploads/test.png"
  ],
  "size": "1024x1024",
  "response_format": "url"
}

1. 后端保存 AccessKey / SecretKey
2. 前端向后端请求上传凭证
3. 后端生成短时有效的上传凭证
4. 前端拿上传凭证上传图片到七牛云
5. 上传成功后得到图片 URL
6. 将图片 URL 填入 images / image 字段调用 API

空间不是公开空间
域名 CNAME 没生效
HTTPS 没配置好
图片路径写错
文件已经被生命周期规则删除
文件名包含特殊字符导致路径不正确

DNS 解析还没完全生效
主机记录填错
记录类型不是 CNAME
同一个子域名已有 A 记录或其他冲突记录
记录值没有填写七牛云提供的 CNAME 地址

http://img.example.com/uploads/test.png

https://img.example.com/uploads/test.png

图片格式不支持
图片太大
图片访问速度太慢
URL 有防盗链限制
URL 已经过期
URL 不是公网可访问
接口字段写错：images / image 混用

uploads/temp/        临时图生图参考图，1～3 天删除
uploads/permanent/   长期保存图片，不设置短生命周期

空间类型：公开空间
存储类型：标准存储
图片域名：独立二级域名，例如 img.example.com
域名解析：CNAME 指向七牛云提供的 CNAME 地址
HTTPS：成本优先时不建议开启；API 参考图推荐使用 HTTP URL
文件命名：随机长文件名，避免中文和空格
生命周期：临时图片 1～3 天自动删除
API 调用：将图片 URL 填入 images 或 image 字段