什么时候用,什么时候不用
适用场景
- 调用失败了:工具没列出来、登录死循环、401、余额不足、参数被拒。
- 任务一直卡在 processing,不确定该等还是该重试。
- 结果出来了,但用户说不出哪里不对。
不适用
- apipod-setup — 还没出错,那是首次运行,不是修故障。
- apipod-generate-image — 结果是效果不对而不是坏掉,那是提示词问题。
执行流程
5 个技能这个技能按顺序做什么。
- 01
先拿到确切的报错原文
先要报错原文再推理。错误码比任何猜测都更快缩小范围。
- 02
区分「没有工具」和「工具报错」
插件装了但没工具,说明服务端没连上:给该客户端的点击路径。连插件都没有,说明地址贴错了地方。
- 03
先查发现文档再怪客户端
GET /oauth-protected-resource/mcp 应当返回 resource: https://api.apipod.ai/mcp。404 说明客户端拿着过期的地址。
- 04
参数被吞了就重读 schema
未知字段是静默丢弃的。重新取 get_model_params,逐字比对字段名和枚举,再确认该设置真的出现在返回里。
- 05
报服务端疑似 bug 时不要带凭证
工具名、发出的参数、报错原文、job_id、大致时间。控制台里的 MCP 请求日志路径是 /mcp。
试一下
从这里直接发出去
示例请求
我的视频任务 vid_7f3a9c 已经 pending 十分钟了,帮我诊断哪里出了问题。
按钮会在新会话里预填这条提示词。若 APIPod 尚未连接,提示词会让助手先停下、协助你完成连接。在 Claude Code 或终端里,直接复制粘贴即可。
调用轨迹
check_job (job_id: "vid_7f3a9c")
→ status: processing · 1–5 分钟属正常
get_model_params (复核失败调用的字段)
→ 字段名与枚举逐字核对
示意轨迹:左侧请求发出后,这个技能按顺序实际会走的工具。价格一律是 estimate_cost 实时返回的形态——本页自己不报价。
它不做的事
它给自己定的规矩。
01
绝不要求用户粘贴 access token。那是凭证,而且排查也用不上。
02
不要为了「把任务推一下」再起一次生成。迟迟不结束的任务最终会在服务端超时并退款。
03
回调域名不在白名单里属于运维改动。把确切域名报出来,不要绕过去。