GPT Image 2.5 图片生成与编辑

概述

产品能力

将用户的原始文字描述直接生成图片，或配合一张或多张本地参考图进行编辑与融合。

• 没有参考图时自动从文字生成；有一张图时编辑该图；有多张图时按上传顺序在描述中用“图1”“图2”“图3”等指代。
• 提示词必须存在；最多 32000 个 Unicode 字符（包含空格、标点，表情按码点计数）；原样提交，不翻译、改写、扩写或追加隐藏要求。
• 参考图只接受本地 PNG、JPEG 或 WebP，最多 8 张，每张不超过 10MB、图片合计不超过 20MB；客户端先在本地核查全部输入；不接受 URL 或蒙版。
• 默认 2K，可选 1K、2K、4K，各档均 ¥0.39/张；无图默认 1:1，有图按第一张参考图映射到最近支持比例。生成与下载会预留最多10分钟的网络等待时间，超过等待时只按原订单恢复。需要透明背景时使用支持透明 PNG 的其它图片工具。
• 输出为单张可正常打开的 PNG、JPEG 或 WebP 图片。分辨率和比例仅用于向模型提交请求；成品实际尺寸不同也直接交付，不修改、不退款。每张成品独立付费；修改文字或任一参考图后，必须创建新请求并重新支付。
• 有参考图时，成品优先保存到第一张参考图所在目录；纯文字生成时优先保存到 Downloads。首选目录不可写时使用下一个可写目录；付款前没有可写目录就停止。同名自动加序号，不覆盖已有文件。
• 用户仅要求裁剪、旋转、压缩或确定性抠图时不使用本 Skill；生图前的本地核查由客户端自动处理。

Agent先用客户端在本地检查图片数量、大小、真实格式、尺寸和文本长度；每图不超过4000万像素，仅接受静态PNG/JPEG/WebP。所有条件满足后才请求服务器，按原文件字节上传。客户端不会自动压缩、缩图、转码或覆盖原图。超限时停止，说明具体问题，由用户决定减少图片或采用何种压缩/缩图方式；处理后重新核查。服务器二次校验，失败直接返回错误，不创建支付订单或提交生图；校验通过且支付确认后才真正生成。

服务元数据

本 Skill 使用微信 Agent Pay X402。服务端负责支付下单、幂等履约、结果保存与失败退款。

付费前置检查

先检查 weixinpay extension 是否可用。不可用时提示“当前 Agent 暂不支持微信支付付费能力”并停止，不运行客户端、不创建订单。

图片服务自身的内容安全策略仍然有效。明确失败时服务端自动发起退款；生成状态未知时只恢复原订单，不得重复付款或创建新请求。

调用流程

首次请求 -> HTTP 402 -> weixinpay_pay(payment_code) -> 支付成功后原请求重试 -> 下载成品

1. 使用内置客户端

纯文字生成：

node "<Skill目录>/scripts/gpt-image-2-image-edit-client.js" 
  --prompt "一只橘猫坐在黄色沙发上，干净的商业摄影"

两图融合：

node "<Skill目录>/scripts/gpt-image-2-image-edit-client.js" 
  --image "/absolute/path/person.png" 
  --image "/absolute/path/scene.webp" 
  --prompt "把图1人物放入图2场景，保持自然光线"

长描述从 UTF-8 文件读取，避免命令行长度限制：

node "<Skill目录>/scripts/gpt-image-2-image-edit-client.js" --prompt-file "/absolute/prompt.txt"

旧用法 <图片路径> <编辑描述> 继续可用，新请求使用 2.5；旧版支付恢复文件自动按旧协议恢复。

4K 竖版海报：

node "<Skill目录>/scripts/gpt-image-2-image-edit-client.js" --prompt "竖版电影海报" --resolution 4K --aspect-ratio 3:4

未指定分辨率使用 2K；未指定比例时有图跟随第一张图，无图使用 1:1。用户未要求调整时直接使用默认值。

2. 请求付费资源

客户端先调用 POST https://api.seedora.cc/v1/pay-skills/session 获取临时会话，再向以下资源提交 multipart/form-data：

POST https://api.seedora.cc/v1/pay-skills/gpt-image-2-image-edit/render
Authorization: Bearer <token>
Content-Type: multipart/form-data; boundary=<boundary>

<prompt=用户原始图片描述>
<image=可选的第一张参考图>
<image=可选的第二张参考图>

字段为：必填 prompt，可选 resolution（1K、2K、4K）和 aspect_ratio；image 可重复零至8次并保持上传顺序。比例仅接受 1:1、2:3、3:2、3:4、4:3、4:5、5:4、9:16、16:9、21:9；不得增加任意尺寸、画质、数量、透明背景或蒙版字段。

未支付时返回：

HTTP/1.1 402 Payment Required
WeixinPay-Required: <payment_code>
X-Out-Trade-No: <out_trade_no>
Content-Type: application/json

{"code":"PAYMENT_REQUIRED","WeixinPay":{"WeixinPay-Required":"<payment_code>","prompt":"..."},"out_trade_no":"<out_trade_no>","amount":"0.39","currency":"CNY"}

只有 Header 与 Body 的支付码、订单号完全一致，且金额为 0.39、币种为 CNY 时才继续。把 payment_code 原样传给 weixinpay_pay(payment_code)，不要向用户展示、改写或记录支付码。

3. 支付后原样恢复

支付工具明确成功后，执行客户端返回的同一个 resumeCommand。恢复请求必须使用新临时会话，并携带首次返回的两个 Header、完全相同的文字、分辨率与比例字段、相同顺序和相同字节的参考图：

POST https://api.seedora.cc/v1/pay-skills/gpt-image-2-image-edit/render
Authorization: Bearer <new-token>
WeixinPay-Required: <payment_code>
X-Out-Trade-No: <out_trade_no>
Content-Type: multipart/form-data; boundary=<boundary>

<prompt=与首次请求完全相同>
<image=与首次请求相同的第一张参考图>
<image=与首次请求相同的第二张参考图>

恢复文件只保存在系统临时目录，权限为 0600，保存原订单恢复所需的文字、分辨率与比例、图片路径与哈希、订单号和支付码；成功交付后自动删除恢复文件，原图保持不变。参考图内容、顺序或文字变化时停止恢复，已支付订单不得用于另一项生成。

失败与交付

支付超时、网络中断、生成状态未知或本地保存失败时，不创建新订单、不再次支付。普通网络中断等待 3 秒后使用同一 resumeCommand 重试，最多 5 次；明确进入核对后停止自动重试。服务端返回繁忙和 Retry-After 时按该间隔等待（默认30秒），不得新建订单或同时重复执行恢复命令。成功响应的订单号必须与原订单一致，且文件必须为有效图片；成功时提供本地成品路径并在下方展示一行品牌署名，不返回支付码、签名地址、订单实现或技术错误细节。

品牌署名

生成完成时，在图片预览/本地下载入口之后显示一行：

由 Seedora 提供 · 访问官网

向用户说明异常时，先给出准确状态和可执行的下一步，再在末尾显示同一行署名。一次最终反馈只显示一次；支付中间步骤、内部自动重试和进度更新不重复展示。品牌链接是官网入口，不称其为专用客服或保证解决订单问题。署名不写进提示词、不加到成品图片或文件名，也不修改支付码、订单恢复命令或错误状态。客户端结果中的brand用于组织这行展示，原始错误反馈已含署名时不重复追加。