火山方舟 → 昆仑引擎 迁移指南
改 2 个值，其余一行不动：base_url、api_key；model 字段保持火山原值
第 1 步 · 改 base_url
- Ark SDK / 火山路径的代码：换成
https://api.yizhuruanjian.com/api/v3 - OpenAI SDK 的代码：换成
https://api.yizhuruanjian.com/api/v1
第 2 步 · 换 api_key
在 控制台 · API Key 管理 创建 Key 并替换。model 字段不用改：火山 Model ID（doubao-seed-…-260628）与接入点 ID（ep-xxx）都会自动映射到平台对应路由； 个别未登记的 ID 联系客服登记即可。
# 火山方舟（原）
base_url = "https://ark.cn-beijing.volces.com/api/v3"
api_key = "ARK_KEY"
# 昆仑引擎（改后）
base_url = "https://api.yizhuruanjian.com/api/v3"
api_key = "YOUR_API_KEY" # model 保持原值切换前自检（1 分钟）
复制下方脚本到客户环境运行（Node 18+，零依赖；会产生一次 1~2 分钱级真实调用）， 四项全过即可切换：
# 下载脚本后运行；或直接向客服索取
node kunlun-connectivity.mjs sk-kl-你的KEY计费与价目（与扣费、公示页同一数据源）
价格来自平台价目表，本页不硬编码任何数字；平台积分口径 1 元 = 100 积分（1 积分 = 1 分）。
doubao-seed-2-1-pro：输入 ¥6.00 / 输出 ¥30.00 / 缓存命中 ¥1.20（元 / 百万 tokens）doubao-seed-evolving：输入 ¥6.00 / 输出 ¥30.00 / 缓存命中 ¥1.20（元 / 百万 tokens）doubao-seed-2-1-turbo：输入 ¥3.00 / 输出 ¥15.00 / 缓存命中 ¥0.60（元 / 百万 tokens）doubao-seed-2-0-mini：输入 ¥0.20 / 输出 ¥2.00 / 缓存命中 ¥0.04（元 / 百万 tokens）- 输入 ≤ 32K：输入 ¥0.20 / 输出 ¥2.00 / 缓存 ¥0.04
- 输入 ≤ 128K：输入 ¥0.40 / 输出 ¥4.00 / 缓存 ¥0.08
- 输入 ≤ 256K：输入 ¥0.80 / 输出 ¥8.00 / 缓存 ¥0.16
glm-5-3-flash-260828：输入 ¥0.80 / 输出 ¥2.80 / 缓存命中 ¥0.00（元 / 百万 tokens）deepseek-v4-flash-ga-260731：输入 ¥3.00 / 输出 ¥9.00 / 缓存命中 ¥0.00（元 / 百万 tokens）deepseek-v4-pro-ga-260813：输入 ¥9.00 / 输出 ¥27.00 / 缓存命中 ¥0.00（元 / 百万 tokens）doubao-seedream-5-0-pro-260628（图片）：¥0.30 / 张（30 积分）doubao-seedream-5-0-lite-260128（图片）：¥0.22 / 张（22 积分）doubao-seedream-4-5-251128（图片）：¥0.25 / 张（25 积分）doubao-seedream-5-0-flash-260915（图片）：¥0.12 / 张（12 积分）ep-20260920164120-g7c6r（视频 720p）：¥1.21 / 秒（121 积分）ep-20260920164120-g7c6r（视频 480p）：¥0.56 / 秒（56 积分）doubao-seedance-2-5-260628（视频 720p）：¥1.51 / 秒（151 积分）doubao-seedance-2-5-260628（视频 480p）：¥0.67 / 秒（67 积分）doubao-seedance-2-5-260628（视频 1080p）：¥3.74 / 秒（374 积分）doubao-embedding-vision-251215（向量 · 文本输入）：¥0.70 / 百万 tokens 输入（70 积分）doubao-embedding-vision-251215（向量 · 图片输入）：¥1.80 / 百万 tokens 输入（180 积分）
常见报错对照
| 报错 | 原因 | 处理 |
|---|---|---|
| 401 invalid_api_key | Key 缺失 / 不完整 / 已禁用 | 控制台重建或检查粘贴；v3 路径同样先鉴权 |
| 403 realname_required | 账号未实名 | 完成企业实名 |
| 402 insufficient_quota | 余额不足 | 控制台充值（支持对公转账） |
| 403 model_not_in_plan | 模型不在套餐档位 | 升级套餐或换可用模型 |
| 404 model_not_found | model ID 未登记 | 联系客服登记映射 |
| 429 rate_limit | 命中 RPM/并发上限 | 按 Retry-After 退避或升级套餐 |
| 503 pricing_missing | 该档价目缺失（平台主动拒服） | 联系客服补齐价目后重试 |
| 503 upstream_unavailable | 平台上游波动 | 稍后重试；持续出现联系客服 |
表中「联系客服」指 在线客服（智能机器人）（产品与接口问题）； 商务合作与报价请走 企业 · 私有化。
行为差异（如实告知）
- 计费按平台公示价（响应头 X-Kunlun-Charged-Cents 给实扣），与火山账单口径独立。
- 内容安全双审（本地引擎 + 腾讯云天御取更严）；违规拦截不扣费。
- Embeddings 已开放：
POST /v1/embeddings与方舟镜像POST /api/v3/embeddings均可用，向量模型填火山原值，按输入 token 计费（详见接入文档第 4 节）。 - 对话多模态输入暂不支持（图片 / 视频生成走专用端点）。
- 视频为异步任务：提交即计费，审核未通过自动原路退款。