🔧 开发者工具

API 迁移工具使用指南

使用 llm-migration-cli 工具,5 分钟内将现有代码从各厂商官方 API 无缝迁移到 AI Token 统一接口,节省 60%+ 成本。

1

工具概述 — 为什么需要迁移

各厂商的 API 虽然大多兼容 OpenAI 格式,但 base_url、模型名称、定价各不相同。直接调用官方 API 意味着:

  • 每个模型一个 API Key,管理麻烦
  • 官方定价较高,成本难以优化
  • 切换模型需要修改代码

通过 AI Token 统一接口,你只需要一个 API Key 就能访问 10+ 主流模型,且价格比官方便宜 60%+。

💡 迁移原理

迁移的本质只是修改两个东西:base_url(指向 AI Token 网关)和 model 名称(映射到 AI Token 支持的名称)。API 调用格式完全兼容 OpenAI SDK,不需要改业务逻辑。

2

安装 llm-migration-cli

终端
# 全局安装迁移工具 npm install -g llm-migration-cli # 验证安装 llm-migration --version # 或者使用 npx 直接运行(无需安装) npx llm-migration-cli detect ./your-project
⚠️ 环境要求

需要 Node.js 16+ 和 npm。支持扫描 JavaScript / TypeScript / Python 项目。

3

自动检测项目中的 API 调用

工具会自动扫描你的项目,识别所有大模型 API 调用点:

终端
# 扫描项目,检测所有 LLM API 调用 llm-migration detect ./my-project # 输出示例: 🔍 扫描中... 📁 发现 12 个文件包含 LLM API 调用 ├─ src/chat.ts (3 处调用: deepseek-chat, qwen-plus) ├─ src/summary.py (2 处调用: deepseek-v3) ├─ src/codegen.ts (5 处调用: deepseek-coder) └─ ... ✅ 共发现 15 处 API 调用,涉及 3 个厂商
支持的厂商检测
# 工具自动识别以下厂商的 API 调用模式: - DeepSeek (base_url: api.deepseek.com) - 通义千问 (base_url: dashscope.aliyuncs.com) - 智谱 GLM (base_url: open.bigmodel.cn) - Moonshot (base_url: api.moonshot.cn) - MiniMax (base_url: api.minimax.chat) - OpenAI (base_url: api.openai.com)
4

执行迁移

确认检测结果后,执行迁移。工具会自动替换 base_url 和模型名称:

终端 — 预览变更(不修改文件)
# 先预览,不实际修改文件 llm-migration migrate ./my-project --dry-run # 输出示例: 📋 迁移计划: [1] src/chat.ts:12 - base_url: "https://api.deepseek.com" → "https://aitoken.zhaoboyang.v6.rocks/v1" - api_key: "sk-***deepseek" → "sk-***aitoken" - model: "deepseek-chat" → "deepseek-v3" [2] src/summary.py:8 - base_url: "https://dashscope.aliyuncs.com/..." → "https://aitoken.zhaoboyang.v6.rocks/v1" - model: "qwen-plus" → "qwen-plus" (无需修改)
终端 — 执行迁移
# 确认无误后执行实际迁移 llm-migration migrate ./my-project # 工具会自动: # 1. 创建文件备份(.backup 后缀) # 2. 替换 base_url 为 AI Token 网关地址 # 3. 替换 API Key 为你的 AI Token Key # 4. 映射模型名称到 AI Token 支持的格式 # 5. 生成迁移报告 ✅ 迁移完成! - 已修改 12 个文件 - 备份保存在 .llm-migration-backup/ - 迁移报告:migration-report.json
✅ 迁移安全

工具会自动创建备份。如需回滚,运行 llm-migration rollback ./my-project

5

手动迁移(不依赖工具)

如果你更喜欢手动操作,或者项目有特殊需求,只需修改以下配置:

JavaScript / TypeScript
const OpenAI = require('openai'); const client = new OpenAI({ // 修改这一行 👇 baseURL: "https://aitoken.zhaoboyang.v6.rocks/v1", apiKey: "sk-your-aitoken-key" }); // 模型名称映射(如果原来用的名字不同) const response = await client.chat.completions.create({ model: "deepseek-v3", // AI Token 模型名 messages: [ { role: "user", content: "你好" } ] });
Python
from openai import OpenAI client = OpenAI( # 修改这一行 👇 base_url="https://aitoken.zhaoboyang.v6.rocks/v1", api_key="sk-your-aitoken-key" ) response = client.chat.completions.create( model="deepseek-v3", messages=[{"role": "user", "content": "你好"}] )
cURL
curl https://aitoken.zhaoboyang.v6.rocks/v1/chat/completions \ -H "Authorization: Bearer sk-your-aitoken-key" \ -H "Content-Type: application/json" \ -d '{ "model": "deepseek-v3", "messages": [{"role": "user", "content": "你好"}] }'
6

验证迁移结果

迁移完成后,运行验证脚本确认一切正常:

验证脚本
# 运行验证 llm-migration verify ./my-project # 或者手动测试 curl https://aitoken.zhaoboyang.v6.rocks/v1/models \ -H "Authorization: Bearer sk-your-aitoken-key" # 应返回可用模型列表

验证清单

检查项预期结果方法
API 连通性返回模型列表GET /v1/models
对话功能正常返回回复发送简单消息测试
流式输出逐字返回设置 stream: true 测试
模型切换不同模型均正常尝试 deepseek-v3, qwen-plus
错误处理错误信息清晰故意发送错误请求
成本验证比之前便宜 60%+对比账单
7

支持的模型映射表

从官方 API 名称到 AI Token 模型名称的映射:

厂商官方名称AI Token 名称说明
DeepSeekdeepseek-chatdeepseek-v3通用对话/代码
deepseek-reasonerdeepseek-r1深度推理
deepseek-coderdeepseek-v3代码(V3已包含)
通义千问qwen-turboqwen-flash轻量高速
qwen-plusqwen-plus均衡主力
qwen-maxqwen-max旗舰推理
智谱glm-4glm-4均衡能力
glm-4-airglm-4-air极致低价
Moonshotmoonshot-v1-128kkimi-k2.5长文本
MiniMaxabab6.5s-chatminimax-m2.5创意对话
8

常见问题

Q: 迁移后原来的代码逻辑需要改吗?

不需要。AI Token 完全兼容 OpenAI API 格式,消息结构、参数、流式输出等全部一致。只需改 base_url 和 model 名称。

Q: 如果 AI Token 服务挂了怎么办?

工具支持回滚。运行 llm-migration rollback 即可恢复原来的配置。也可以在代码中加 fallback 逻辑。

Q: 价格真的能省 60%+?

是的。AI Token 通过聚合多厂商算力、优化路由和缓存策略,将成本大幅压缩。具体节省比例取决于你之前使用的厂商和模型。

Q: 支持 Python 项目吗?

支持。工具可以扫描 Python 项目中的 openai SDK 调用和 dashscope SDK 调用,并生成对应的迁移方案。

🎯 准备好迁移了吗?

注册 AI Token,获取 API Key,5 分钟完成迁移。使用兑换码立获 ¥20 免费额度。

免费注册
兑换码:DEVSTARTER20 → ¥20 免费额度
🚀 38+中国大模型API · ¥99/月起 立即订阅 → 💬 免费咨询