TokenLab OpenAI 兼容迁移

当用户需要将现有的 OpenAI 兼容集成、OpenRouter 配置、LiteLLM 设置、LangChain/LlamaIndex 应用或自定义 SDK 包装器迁移到 TokenLab 时，请使用此技能。

该技能应交付的内容

• 尽可能小的变更差异或配置调整，以保留原有的用户路径。
• 正确的 TokenLab 基础 URL 和 API 密钥环境变量。
• 包含实时发现命令的模型迁移说明。
• 当旧代码实际需要 Responses、Anthropic Messages、Gemini 内容、媒体、音频、嵌入、重排序或翻译行为时，提供原生端点说明。
• 提供可恢复至先前提供商配置的回滚说明。

默认迁移规则

• OpenAI 兼容 SDK：

- 基础 URL：https://api.tokenlab.sh/v1

- 认证方式：Authorization: Bearer $TOKENLAB_API_KEY

- 对话路径：/v1/chat/completions

• Anthropic 原生客户端：

- 基础 URL：https://api.tokenlab.sh

- 消息路径：/v1/messages

• Gemini 原生客户端：

- 基础 URL：https://api.tokenlab.sh

- 生成内容路径：/v1beta/models/{model}:generateContent

• 实时发现：

- GET https://api.tokenlab.sh/v1/models

- GET https://api.tokenlab.sh/v1/models?recommended_for=<scene>

- GET https://api.tokenlab.sh/v1/models/:model

推荐操作流程

1. 定位当前提供商的配置、环境变量和模型 ID。
2. 首先进行最小范围的更改：

- 替换基础 URL

- 替换 API 密钥变量

- 保持 SDK/客户端结构不变

1. 仅在应用程序中硬编码了特定提供商模型时，添加模型发现功能。
2. 当源集成使用 Responses、Anthropic Messages、Gemini 内容部分、工具、媒体、音频、嵌入、重排序或翻译时，保持原生语义。
3. 提供一个用于验证迁移路径的烟雾测试命令。

输出格式

• 一段简短的迁移表面说明。
• 一份聚焦的变更差值、配置块或可运行的替换代码片段。
• 一条烟雾测试命令。
• 一条模型发现命令。
• 一条回滚指令，明确指出之前的基地址和环境变量。

避免事项

• 如果仅需更改基础 URL，不要重写用户的 SDK 架构。
• 除非用户明确接受行为变化，否则不要将原生 Anthropic 或 Gemini 响应体扁平化为通用聊天格式。
• 当现有模型在 TokenLab 中无明显对应项时，不要静默更改模型。
• 不要在源代码文件或提示词中嵌入 API 密钥。
• 在未检查模型详情端点前，不要声称功能完全对等。

特殊情况处理

• 若应用对对话、嵌入和媒体使用不同的基础 URL，应逐个类别依次迁移。
• 若现有应用使用 OpenRouter 模型别名，应在查阅目录后，仅将它们映射到 TokenLab 的公开模型 ID。
• 若用户之前的提供商使用特定于提供商的请求头，仅保留 TokenLab 文档中列出或应用仍需的头部。