从 OpenAI 迁移到本平台

平台兼容 OpenAI 协议，迁移通常只需要改三样东西：Base URL、API Key、模型名。

Python（官方 SDK）

from openai import OpenAI

client = OpenAI(
    api_key="sk-heima-xxxxxxxx",
    base_url="https://api.token.heimatianqi.com/v1",
)

resp = client.chat.completions.create(
    model="deepseek-v4-flash",
    messages=[{"role": "user", "content": "你好"}],
)
print(resp.choices[0].message.content)

Node.js

import OpenAI from 'openai'

const client = new OpenAI({
  apiKey: 'sk-heima-xxxxxxxx',
  baseURL: 'https://api.token.heimatianqi.com/v1',
})

const resp = await client.chat.completions.create({
  model: 'deepseek-v4-flash',
  messages: [{ role: 'user', content: '你好' }],
})
console.log(resp.choices[0].message.content)

迁移检查清单

• Base URL 以 /v1 结尾，不要再手工拼 /chat/completions 之外的前缀。
• 模型名换成平台公开名（控制台「模型与价格」里复制）。
• 如果原来依赖 usage 字段计费，确认代码读的是响应里的 usage（平台按上游真实用量返回）。
• 给新 Key 设置模型白名单与额度上限，避免迁移期间意外超支。
• 加上 429/5xx 的指数退避重试（见「错误码与限流」）。

平台差异（需要改代码的地方）

差异	说明
高峰倍率	工作日 09:00–12:00 / 14:00–18:00 价格上浮；如需恒定价格可在应用侧避开高峰或选平价模型
实名门槛	图像/视觉类模型需要实名，未实名返回 403 realname_required
任务类接口	绘图/视频是异步任务，不是 chat/completions
计费单位	人民币 / 1M tokens（三价：输入/缓存/输出）