GPT Image 2.5 生图工作室

技能文档

---
name: gpt-image-2-5-studio
title: GPT Image 2.5 生图工作室
category: 内容创作
description: 用 GPT Image 2.5 模型制作单张静帧：文生图与参考图生图，默认 2K 方图，适合中文海报、商品图、信息图和社媒画面，图上文字、人脸、产品和标识按必须保住项处理，交付后核对图上文字与主体身份。当用户提到生成图片、文生图、图生图、做海报、商品图、信息图、社媒配图时触发。
---

# 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`。

上传前检查每份本地源。上传只是传输，不是检查：

```text
python3 scripts/mcp_client.py upload ./reference.png --mime-type image/png
```

## 技能工作流

### 步骤1：判定路线并撰写说明

判定 generate 还是 transform。写一份紧凑说明：信息、主体、构图、风格、图上文字、必须保住项、画幅，以及 Flare 或 Sunburst。按顺序写明每张参考图的角色。

### 步骤2：查询实时模型卡并冻结载荷

为选定能力调用 `beatra.models.list`，读取现网卡片——提示词上限、源图数量、画幅和价格——再冻结付费载荷：

```bash
python3 scripts/mcp_client.py call beatra.models.list
```

```json
{"capability": "text_to_image"}
```

   transform 同样使用 `{"capability": "image_to_image"}`。见
   [GPT Image 2.5 workflow](references/workflow.md)。
### 步骤3：出示生产卡并提交

出示六字段生产卡并等待。批准后生成一个不透明 `client_request_id`，只通过随包
   `scripts/mcp_client.py` 提交一次。
### 步骤4：轮询、交付与核对

用 `beatra.tasks.get` 轮询。交付实际字节、尺寸、终态模型和 `billing.net_charged_credits`。核对图上文字和必须保住项，然后最多给一个尚未执行的后续方向。

## 需要确认的决定

规划、带标注的说明和当场报价不扣费。它们不是批准。

每次付费调用（`beatra.images.generate` 或
`beatra.images.transform`）前，出示一张当前生产卡并等待：

1. 做什么 — 用用户的话说明本笔，并标明这是 generate 还是 transform 调用。
2. 积分 — 刚从模型卡读到的价格。不要复用记忆中的数字。
3. 几笔 — 本轮一次付费调用。每张静帧一次调用。
4. 身份 — 每笔一个新的不透明 `client_request_id`。提示词、
   文件、模型或控件变了就换新标识。禁止把同一标识
   用在不同参数上。
5. 若停在这里 — 带标注的说明仍然可用。
6. 若余额不足 — 原样转达官方说明和充值链接。翻译正文，保留链接。用户说已充值之前不要重试。

只通过随包 `scripts/mcp_client.py` 提交一次。用
`beatra.tasks.get` 轮询。交付实际字节和
`billing.net_charged_credits`。不要承诺预估就是最终扣费。

拒绝「一次批准覆盖重试」。拒绝静默 `auto`。

## 执行

每个远程 Beatra 操作都只通过本包随附的
`scripts/mcp_client.py` 调用。把 MCP 工具名放在 `call` 后面，并向标准输入发送一个 JSON 对象。不要配置或调用宿主 Beatra
Connector，也不要使用 REST/OpenAPI 作为降级。

```text
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)
- 授权与连接：[安装与身份验证](references/installation-and-auth.md)
- 共用的任务和计费细节：[tasks and results](references/tasks-and-results.md)，
  [billing, errors, and recovery](references/billing-errors-and-recovery.md)
- 连接帮助：[随包客户端连接诊断](references/mcp-connection.md)

## 随包客户端说明

每个远程操作都只通过随包 `scripts/mcp_client.py` 调用。客户端不联网检查更新，也不上报安装信息；首次使用或连接过期时运行 `python3 scripts/authorize.py` 完成一次浏览器授权即可。

使用说明

# GPT Image 2.5 生图工作室

用 GPT Image 2.5 模型制作单张静帧：文生图与参考图生图，适合中文海报、商品图、信息图和社媒画面，图上文字与产品标识按必须保住项处理。

## 使用

首次使用先完成一次浏览器授权（只需一次）：

```text
python3 scripts/authorize.py
```

然后直接描述需求，例如：

```text
做一张 2K 方图海报：主题"春日咖啡节"，主标题四个大字，暖色调
参考这 3 张图生成一张新的产品场景图，保持瓶身标识不变
```

技能会确认画面方向与画幅、核对实时模型约束、出示付费确认，并在交付时报告实际尺寸与扣费。

## 工作原理

所有生成操作通过随包客户端 `scripts/mcp_client.py` 以 MCP 协议调用服务端完成；本地参考图先上传转为 artifact 引用。技能负责模型卡核对、生产卡确认、任务轮询与交付检查；载荷细则见 references/workflow.md。

如何安装此技能？

访问技能市场，点击「安装」按钮，按提示将技能包放入 AI 编程助手的 skills 目录即可。