SDK 迁移指南

从官方或其他中继迁移到 NexusKey，通常只改两行：base_url 与 api_key。

从 OpenAI 官方迁移

 client = OpenAI(
-    api_key=os.environ["OPENAI_API_KEY"],
+    base_url="https://api.nexuskey.cn/v1",
+    api_key=os.environ["NEXUSKEY_API_KEY"],
 )

• 模型名改为 NexusKey 可用模型（GET /v1/models）；
• 其余参数（tools、stream、response_format）保持原样。

从 Anthropic 官方迁移

 client = Anthropic(
+    base_url="https://api.nexuskey.cn",
     api_key=os.environ["NEXUSKEY_API_KEY"],
 )

常见坑

base_url 不要带 /v1：Anthropic SDK 会自拼 /v1/messages，多一层会 404。

从其他中继迁移

检查项	说明
端点前缀	本站不使用 /api/anthropic 式别名前缀，按原生路径
模型别名	本站透传上游原名，旧中继的别名映射需还原
错误处理	协议端点为原生错误结构，旧中继自定义错误码需清理
计费查询	换用 GET /v1/platform/billing 与 GET /v1/usage

环境变量约定

export NEXUSKEY_API_KEY="sk-…"
export NEXUSKEY_OPENAI_BASE="https://api.nexuskey.cn/v1"
export NEXUSKEY_ANTHROPIC_BASE="https://api.nexuskey.cn"

迁移验证清单

• [ ] GET /v1/models 200 且列表非空（空 = Key 未分配分组）
• [ ] 非流式 + 流式各一发成功，usage 字段存在
• [ ] 429 重试逻辑读取 Retry-After
• [ ] 流内 error 事件处理（Anthropic 协议）
• [ ] 对账：/v1/usage 与自有日志对齐一个结算周期