用途:把代码库从 Runpod GraphQL API 或 REST v1 迁移到 REST v2。先推断范围(全部、仅 REST 或仅 GraphQL),不先发问卷;账户/计费身份(myself)与 spot/可中断 Pod 无 v2 替代,仍需留在 GraphQL;serverless 作业 API(api.runpod.ai/v2/...)不在范围内,不要改动。
主要能力:自带扫描脚本对调用点按代际分类(GraphQL、REST v1、v1/GraphQL 字段名、REST v2、serverless 作业 API、SDK/CLI 包装),区分 api.runpod.ai 与 api.runpod.io;输出 Markdown/JSON;支持 --scope rest 与 --fail-on-legacy。能识别同名字段、包装器间接调用等风险,但 SDK 包装、生成客户端、配置中的基址与 helper 拼装路径仍需人工核查。
使用方式:先运行 python3 "$SCAN" . > runpod-api-inventory.md 或 --json;阅读 reference/breaking-changes.md 并告知适用项;按必需、清理、需用户决策三类写计划;逐文件迁移,每个文件一次提交,先迁移共享传输 helper;请求 catalog 时始终带 include=AVAILABILITY,且 product 必填(如 GET /v2/catalog/gpus?include=AVAILABILITY&product=POD);迁移后运行 python3 "$SCAN" . --scope rest --fail-on-legacy 验证,用 rp-migrate: keep-v1 或 rp-migrate: ignore 标记;最后按指定小节输出总结。
适用场景与限制:适合已有 Runpod 调用需要升级到 v2 的项目。必要命令保持原样。资料未提供具体收费、价格与完整功能效果信息;v2 仍在积极开发,映射表以 2026-08-10 为准,官方规范可通过 curl -s https://api.runpod.io/v2/openapi.json 与 https://rest.runpod.io/v1/openapi.json 获取,冲突时以线上实际行为优先,其次规范,再次表格。