迁移指南：从其他平台切到 AnideaAI
本文给出最短迁移路径，目标是让已有项目在不重构业务代码的前提下完成切换。
一句话迁移结论
如果你当前使用的是 OpenAI 兼容接口，通常只需要改两处：
- 基础地址改为
https://anideaai.com/v1 - API 密钥改为 AnideaAI 控制台签发的
sk-xxxxx
迁移前检查清单
- 已在
https://anideaai.com/console创建可用密钥 - 已确认目标模型可在
/v1/models查询到 - 已梳理当前系统里的超时、重试和日志配置
- 已准备灰度发布方案（先小流量再全量）
从 OpenAI 官方迁移
参数映射
| 原配置 | 迁移后配置 |
|---|---|
https://api.openai.com/v1 | https://anideaai.com/v1 |
| OpenAI Key | AnideaAI Key（sk-xxxxx） |
| OpenAI 模型名 | AnideaAI 已开放模型名（以 /v1/models 为准） |
cURL 示例
curl https://anideaai.com/v1/chat/completions \
-H "Content-Type: application/json" \
-H "Authorization: Bearer sk-xxxxx" \
-d '{
"model": "gpt-5.4",
"messages": [{"role": "user", "content": "给我一段迁移自检清单"}]
}'
Python 示例
from openai import OpenAI
client = OpenAI(
api_key="sk-xxxxx",
base_url="https://anideaai.com/v1"
)
resp = client.chat.completions.create(
model="gpt-5.4",
messages=[{"role": "user", "content": "输出一条成功标记"}]
)
print(resp.choices[0].message.content)
Node.js 示例
import OpenAI from 'openai';
const client = new OpenAI({
apiKey: 'sk-xxxxx',
baseURL: 'https://anideaai.com/v1'
});
const resp = await client.chat.completions.create({
model: 'gpt-5.4',
messages: [{ role: 'user', content: '输出一条成功标记' }]
});
console.log(resp.choices[0].message.content);
从其他中转平台迁移
常见迁移源：OpenRouter、AIML API、接口AI、兔子、AiHubMix、SiliconFlow 等。
迁移步骤
- 把基础地址统一替换为
https://anideaai.com/v1 - 替换 API 密钥
- 清理旧平台专有请求头
- 重新确认模型名是否一致
- 跑一轮回归测试（成功率、时延、成本）
重点差异提醒
| 检查项 | 典型问题 | 处理方式 |
|---|---|---|
| 基础地址格式 | 旧平台有的需要不带 /v1 | 统一按 https://anideaai.com/v1 |
| 模型名 | 旧平台别名在新平台不可用 | 先调用 /v1/models 对齐 |
| 私有请求头 | 遗留渠道路由头导致异常 | 删除非必要自定义头 |
| 限流策略 | 平台间限流维度不同 | 补齐 429 退避重试逻辑 |
建议的灰度迁移流程
- 先用 5% 流量接入 AnideaAI
- 对比成功率、平均耗时、单次成本
- 连续观察至少 24 小时
- 指标稳定后逐步扩大到全量
迁移验收清单
- 所有调用地址已替换为
https://anideaai.com/v1 - 生产环境密钥已替换且权限正确
- 核心接口（对话、向量、图像等）都通过冒烟测试
- 已完成错误码与重试策略自检
- 日志可追踪
request_id/trace_id
常见问题
1. 迁移后返回 404
优先检查接口路径和模型名；路径要与 OpenAI 兼容接口一致。
2. 迁移后返回 429
说明达到频率或并发限制，需按限流文档增加退避重试和流量整形。
3. 迁移后成本波动明显
请按模型维度对比输入输出量、调用分布和失败重试次数，避免因重试放大成本。