GPT Image 2.5生图
按创作者实际起点，做成一张 GPT Image 2.5 静帧。把模型钉在 GPT Image 2.5。不要发送 auto。复用对话里已有的决定。只有缺了会改路线或付费结果的输入时才问。
你会得到什么
- 每次确认调用一张静帧。
- 默认画幅 2K 方图，除非投放位置需要别的比例。
- 图上文字、人脸、产品和标识当作必须保住项。
怎么跑
| 起点 | 工具 | 能力 |
|---|---|---|
| 一段文字说明，没有源图 | beatra.images.generate |
text_to_image |
| 一到四张有序参考图 | beatra.images.transform |
image_to_image |
载荷见 GPT Image 2.5 workflow（references/workflow.md）。不要调用 beatra.images.edit。交付后再做的局部改动，是新的 transform 或 generate。
输入和默认值
硬输入是非空的画面方向。transform 还需要一到四张可访问的参考图。不要为了跳过提问去编造场景、产品或参考图。复用去处、主体、图上文字、风格、必须保住项、画幅，以及点名的 GPT Image 2.5 SKU。
默认 model 为 gpt-image-2.5-flare。仅当创作者点名 Sunburst、最细画质，或参考图身份很重时，使用 gpt-image-2.5-sunburst。禁止静默换 SKU。
默认 count 为 1，output_relationship 为 independent。默认画幅为 2K 1:1 预设。去处需要 16:9、9:16、7:3 或其他现网 GPT Image 2.5 比例时再改 aspect。只有创作者点名 4K 时才发送 4K。
上传前检查每份本地源。上传只是传输，不是检查：
python3 scripts/mcp_client.py upload ./reference.png --mime-type image/png
黄金路径
- 判定 generate 还是 transform。写一份紧凑说明：信息、主体、构图、风格、图上文字、必须保住项、画幅，以及 Flare 或 Sunburst。按顺序写明每张参考图的角色。
- 这份带标注的说明就是免费可见结果。规划不是批准。
- 为选定能力调用
beatra.models.list，读取现网卡片——提示词上限、源图数量、画幅和价格——再冻结付费载荷：
python3 scripts/mcp_client.py call beatra.models.list
{"capability": "text_to_image"}
transform 同样使用 {"capability": "image_to_image"}。见
GPT Image 2.5 workflow（references/workflow.md）。
4. 出示六字段生产卡并等待。批准后生成一个不透明 client_request_id，只通过随包
scripts/mcp_client.py 提交一次。
5. 用 beatra.tasks.get 轮询。交付实际字节、尺寸、终态模型和 billing.net_charged_credits。核对图上文字和必须保住项，然后最多给一个尚未执行的后续方向。
需要确认的决定
规划、带标注的说明和当场报价不扣费。它们不是批准。
每次付费调用（beatra.images.generate 或
beatra.images.transform）前，出示一张当前生产卡并等待：
- 做什么 — 用用户的话说明本笔，并标明这是 generate 还是 transform 调用。
- 积分 — 刚从模型卡读到的价格。不要复用记忆中的数字。
- 几笔 — 本轮一次付费调用。每张静帧一次调用。
- 身份 — 每笔一个新的不透明
client_request_id。提示词、
文件、模型或控件变了就换新标识。禁止把同一标识
用在不同参数上。 - 若停在这里 — 带标注的说明仍然可用。
- 若余额不足 — 原样转达官方说明和充值链接。翻译正文，保留链接。用户说已充值之前不要重试。
只通过随包 scripts/mcp_client.py 提交一次。用
beatra.tasks.get 轮询。交付实际字节和
billing.net_charged_credits。不要承诺预估就是最终扣费。
拒绝「一次批准覆盖重试」。拒绝静默 auto。
执行
每个远程 Beatra 操作都只通过本包随附的
scripts/mcp_client.py 调用。把 MCP 工具名放在 call 后面，并向标准输入发送一个 JSON 对象。不要配置或调用宿主 Beatra
Connector，也不要使用 REST/OpenAPI 作为降级。
printf '%s' '{"prompt":"A matte red cube on a white studio table, no extra props.","model":"gpt-image-2.5-flare","count":1,"canvas":{"type":"preset","tier":"2K","aspect":"1:1"},"output_relationship":"independent","client_request_id":"opaque-gpt25-01"}' | python3 scripts/mcp_client.py call beatra.images.generate
审图、交付与恢复
核对可读的图上文字、主体身份、构图和去处适配。只报告宿主实际看得见的内容。
拿到 task_id 后轮询该任务。创建响应丢失时，只用原来的标识重试完全相同的冻结载荷。任务标识缺失时，先用 beatra.tasks.list 再用 beatra.tasks.get 核对候选，然后再提交。只有创作者要求时才调用 beatra.tasks.cancel。提示词、文件、模型或画幅变了，就是新的付费工作，要换新卡和新标识。
工具返回积分不足时：把工具返回的原文整段交给用户，链接一个字不改。其余可以译成中文。不要改写成自己的充值说明。引导用户按原文去充值。
账户余额
用户问还剩多少积分，或某次实时估价够不够时，调用 beatra.wallet.get。问已经扣了多少
时，调用 beatra.wallet.ledger。两者都是只读的。不要臆造查余额或充值的工具。也不要把
wallet.get 变成每次付费提交前的必需步骤。
模型卡返回里带 top_up 块时，按卡片给出的档位和顺序原样转述。不要给档位排高低，不要
贬低其中任何一档，也不要替用户挑。选哪一档是用户自己的事，钱包页会把整份清单摆在他
面前。任何时候都不要凭记忆报档位。
按任务查阅的参考
- 载荷、transform JSON、轮询和恢复：
GPT Image 2.5 workflow（references/workflow.md） - 授权和注册：
installation and authentication（references/installation-and-auth.md），
installation registration（references/installation-registration.md） - 共用的任务和计费细节：tasks and results（references/tasks-and-results.md），
billing, errors, and recovery（references/billing-errors-and-recovery.md） - 连接帮助：随包 MCP Client 连接诊断（references/mcp-connection.md）
- 更新与安全：更新与安全（references/updates-and-security.md）
- 移除：uninstall and disconnect（references/uninstall-and-disconnect.md）
更新与安全
本 Skill 会自动更新。内置客户端每天最多一次从 Beatra 官网读取本渠道的版本信息
（中国大陆网络走 www.beatra.cn 与 cdn.beatra.cn）。有新版本时，它下载官方发布包，
逐个文件校验 SHA-256，再替换本 Skill 自己的文件；你放进这个目录的其他文件不会被
改动。替换过程中断时，下次运行会自动恢复到替换前的状态。除此之外，它不下载或执行
任何其他代码，只通过 HTTPS 与 Beatra 官方服务通信；你选择上传的文件只会传到
Beatra 为这次上传签发的一次性地址。
关闭自动更新：python3 scripts/mcp_client.py update --auto off。关闭后，客户端每天
最多提示一次在你安装它的商店里更新的命令。详见更新与安全（references/updates-and-security.md）。
