---
name: test-billing
description: 计费流程测试技能。调用即梦图片生成API测试计费闭环：故意不传token触发错误 → 识别错误 → 展示充值链接 → 用户支付后用新token重试。
version: 1.1.0
author: nkkj-BrainHack
---

# test-billing

## 功能用途

计费流程端到端测试技能，验证从 API 调用 → 错误识别 → 充值引导 → 重试的完整闭环。

## 调用链（Workflow）

```
Step 1: 调用即梦API（故意不传token） → 获取错误响应
Step 2: 识别错误类型（未授权 or 余额不足）
Step 3: 向用户展示充值链接
Step 4: 用户支付后，携带token重试API
```

## 入参规则

| 参数 | 类型 | 必填 | 说明 |
|------|------|------|------|
| prompt | string | ✅ | 任意文本即可（如"测试"） |
| token | string | ❌ | 认证token（首次测试故意不传） |

## 接口调用方式

- **请求方法**: POST
- **接口地址**: `https://server.fmode.cn/api/volcengine/jimeng/getImgV4`

```json
{
  "prompt": "测试",
  "sizeDate": { "width": 512, "height": 512 },
  "scale": 0.6,
  "force_single": true
}
```

## 错误识别规则（重要 — Agent 必须执行）

调用API后，检查响应内容，按以下规则判断：

### 情况A：未授权（无token或token无效）
**匹配条件**（任一满足即触发）：
- `error.message` 包含 "API_KEY" 或 "sessionToken"
- `code` 为 401 或 403
- `msg` 包含 "unauthorized" 或 "token" 或 "invalid"

**Agent 动作**：向用户展示以下消息（必须包含可点击链接）：

```
⚠️ API 返回未授权错误，需要开通服务。

请点击下方链接扫码支付开通：
👉 https://pwa.fmode.cn/apig-pay.html

支付完成后，请把获取到的 token 发给我，我会用新 token 重新调用。
```

### 情况B：余额不足
**匹配条件**（任一满足即触发）：
- `code` 为 -2、-3、-10、402 或 429
- `msg` 包含 "余额不足" 或 "insufficient" 或 "balance"

**Agent 动作**：向用户展示以下消息：

```
⚠️ API 返回余额不足，需要充值。

请点击下方链接扫码充值：
👉 https://pwa.fmode.cn/apig-pay.html

充值完成后告诉我，我会重新调用。
```

### 情况C：调用成功
- `code` 为 200 且 `data` 存在
- **Agent 动作**：展示成功结果，报告测试通过

## 重试逻辑

用户支付后提供 token 时，重新调用API，在请求body中添加 `"token": "用户提供的token"`。

## 测试报告模板

调用完成后，向用户报告测试结果：

```
📋 test-billing 测试报告
━━━━━━━━━━━━━━━━━━━━

| 测试项 | 状态 | 说明 |
|--------|------|------|
| API 调用 | ✅/❌ | 是否成功发送请求 |
| 错误识别 | ✅/❌ | 是否正确识别了错误类型 |
| 充值引导 | ✅/❌ | 是否展示了充值链接 |
| Token重试 | ✅/❌/⏳ | 用户支付后是否成功重试 |
```

## 费用

图片生成v4: **0.22元/张**（测试时如成功会产生费用）

## 依赖要求

- 接口地址: `https://server.fmode.cn/api/volcengine/jimeng/getImgV4`
- 充值页面: `https://pwa.fmode.cn/apig-pay.html`