Image-2.5-sunburst 图像生成

概述

付费图片生成

每次生成 1 张图片，标价人民币 0.30 元；实际付款金额以 HTTP 402 返回的 amount_fen 为准，金额与本次授权不符时先说明并取得相应授权。使用 Image 2.5，模型固定为 gpt-image-2.5-auto，尺寸由商家工作台配置。客户端不能设置模型、尺寸或张数，不把一个请求自动拆成多笔订单。白底、裁剪等本地处理版本是同一模型结果的衍生图，不能算作额外的模型生成图片。商家后端代理上游生图服务；技能无需也不得包含上游密钥。

调用前

• 确认用户同意将本次提示词、参考图 URL 或本地图片内容发送给收费服务。真实收费调用前，必须先通过工具发现确认当前环境存在名称包含 weixinpay_ 的 WorkBuddy 微信支付工具；没有则说明当前无法完成微信付款并停止，不创建订单。
• 付款遵循现有用户授权；已经明确授权本次交易不重复询问。只有 mode: wechat 的真实支付信息可传给微信工具，并使用工具实际定义的参数，不猜测支付成功。
• 查看同目录 config.json。本包商家 API 地址为 https://www.moshuinsight.com/skillpay；以实际商家部署验证结果为准。
• 只有用户明确要求本地演练时可跳过微信工具检查并使用 mock。mock 支付码不能交给真实微信工具。

发起任务

把提示词保存为 UTF-8 文件：非空、无 NUL，最多 12,000 UTF-8 字节。可选参考图合计最多 4 张，支持公网 HTTPS URL 与本地 PNG、JPEG、WebP 文件混用。URL 每个最多 4,096 UTF-8 字节，不能含用户名、密码、片段或指向内网。每个本地文件最多 4 MiB，文件合计最多 8 MiB；扩展名必须与图片特征一致。

用户要求参考图时，先确认图片文件可访问或取得符合要求的 URL。若附件在当前环境不可访问，明确请用户重新提供图片，并停止创建付款单；不能悄悄删掉参考图或改成纯文字生成。

在技能目录执行（也可用脚本绝对路径）：

python scripts/invoke.py start --prompt-file /absolute/path/prompt.txt --session /absolute/path/work/image-session.json

参考图可重复传入 --reference-url https://public-host/path.png 和 --reference-file /absolute/path/reference.png，混用时保持命令中的出现顺序。例如：

python scripts/invoke.py start --prompt-file /absolute/path/prompt.txt --reference-file /absolute/path/reference.png --reference-url https://public-host/second.jpg --session /absolute/path/work/image-session.json

脚本在创建订单前校验全部参考图，把本地文件内容快照为标准 base64 data URI 存入原请求的 image_urls，不上传本地路径；完整请求最多 12 MiB。新会话文件必须不存在且位于技能目录外。会话含提示词、参考图内容或链接、幂等键、订单和结果，不得发布或提交仓库；不要打印或转述其中的 data URI。服务地址默认来自 config.json，也可用 --base-url 指定已确认的商家地址。

脚本在请求前落盘，始终输出 JSON：

• PAYMENT_REQUIRED / 402：说明本次金额和一张图片的交付内容。仅在真实 wechat 模式下，将服务返回的 WeixinPay.WeixinPay-Required（与 payment_code 一致）交给当前微信支付工具，按授权完成付款。
• PROCESSING / 202：已支付、正在生成。不能再次付款。使用原会话继续查询。
• SUCCESS / 200：展示图片和 result.expires_at。若有效期为空，说明“供应商未提供有效期，请立即下载”，不要因此拒绝成功结果。链接短期有效，及时下载保存，再向用户展示本地图片；already_fulfilled: true 是同一订单的原结果。

原订单恢复

python scripts/invoke.py resume --session /absolute/path/work/image-session.json --wait

--wait 最多等待 120 秒，只轮询 202；也可用 --wait 30。每次间隔按服务端建议限制在 3–10 秒。到期仍处理中就保留会话，稍后恢复。脚本保持原始请求、Idempotency-Key 和已知的 X-Out-Trade-No；恢复直接使用已保存的参考图快照，不重新读取本地文件，即使文件后来变更或删除也不改变本次请求。不得编辑会话来改变本次输入。旧版会话可以继续恢复和下载。

• 付款后仍为 402：仅表示服务尚未确认付款。先核对付款工具结果，再恢复原会话；不能自动重付。
• 任意阶段的 503（包括首次 SERVICE_UNAVAILABLE）、断网、超时或响应异常：保留原会话，只能 resume；不重新 start、不换幂等键、不另付一次。首次 503 不代表已经创建订单。
• GENERATION_FAILED / 502 或 REFUNDED / 409：本订单停止自动生成，保留原订单号。refund_status: manual_review 需联系商家人工核对，不能宣称钱已退回；refund_pending 表示退款处理中；refunded 表示服务端已确认退款成功。脚本对这两种终态只返回已保存状态，不重新发送生成请求；处理中状态后续向商家核对。
• 订单号变化、输入损坏或 PAYMENT_STATE_CONFLICT：停止付款与自动重试，保留会话并联系商家排查。

保存图片

python scripts/invoke.py download --session /absolute/path/work/image-session.json --output-dir /absolute/path/images

仅下载已成功返回的图片。下载使用独立的公网 HTTPS 连接，不携带支付或 API 头；检查 DNS、重定向、图片 MIME、文件特征和 30 MiB 上限。不会覆盖已有文件；输出 files 是实际保存的绝对路径。失败时保留订单，链接过期需联系商家核对，不能自行重购。

若 VPN 或代理把图片域名解析为 198.18.x.x 等非公网地址，下载会被安全校验拒绝。恢复可直接访问图片域名的网络后，使用原会话重试下载；不放宽地址校验，也不另付费生成。

200、202、402 和下载成功退出码为 0，网络或服务异常为 1，本地参数或会话错误为 2。生产 API 要求 HTTPS；HTTP 仅允许本机演练。