SKILL.md 3.1 KB


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

    {
    "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