5分钟从 OpenAI 迁移到 Celedog：零代码改动指南
作者： 技术内容团队 @ Celedog
发布日期： 2023-10-27
你是否曾因为需要为不同的 AI 模型重复修改代码而感到疲惫？或者，你是否正在寻找一种更经济、更灵活的方式，将多种顶尖模型集成到你的应用中，却对复杂的多平台管理望而却步？根据我们的调研，超过60%的开发者在使用多个 AI API 时，最大的痛点并非模型本身，而是维护多个不兼容的接口和繁琐的密钥管理。
如果你现在的应用基于 OpenAI API，那么迁移到一个更强大、更经济的聚合平台可能比你想象的要简单得多。本文将向你展示，如何利用 Celedog 强大的OpenAI兼容性，在几乎不改动任何代码的前提下，完成一次平滑、高效的迁移。
为什么选择 Celedog？
在深入迁移步骤之前，让我们先快速了解 Celedog 的核心价值。它不仅仅是一个 API 代理，而是一个真正的 AI 模型 API 聚合网关。
- 海量模型，一站接入：超过 200 模型，覆盖来自 OpenAI、Claude、Llama、Mistral、国内顶尖大模型（如通义千问、文心一言、智谱）等 30+ 顶级提供商。
- 智能路由，成本优化：内置的智能路由引擎可根据任务复杂度、延迟要求自动选择最优模型，平均节省 20-40% 的 API 成本。
- 多币种结算：支持 USD、CNY、IDR 等多种货币，为全球开发者提供本地化支付体验。
- 零代码迁移：提供完全兼容 OpenAI 的 API 端点和请求格式。
迁移核心：理解 Celedog 的 OpenAI 兼容性
Celedog 的“OpenAI兼容”意味着什么？简而言之，你可以将 Celedog 视作一个功能更强大、模型更多的“OpenAI”。你现有的、针对 OpenAI API 编写的代码逻辑，只需调整两个参数，即可无缝对接 Celedog 的庞大模型库。
| 特性 | OpenAI API | Celedog 网关 |
|---|---|---|
| API 端点 | https://api.openai.com/v1/... |
https://api.celedog.io/v1/... |
| 认证方式 | Authorization: Bearer sk-xxx |
Authorization: Bearer cldg-xxx (同一 Header 格式) |
| 支持的模型 | OpenAI 系列 (GPT-3.5, GPT-4等) | OpenAI全系列 + Claude + Llama + 国产模型 + ... (200+) |
| 请求/响应格式 | 标准 OpenAI JSON 格式 | 完全一致 |
| 价格 | OpenAI 官方定价 | 提供更具竞争力的聚合定价，并有智能路由优惠 |
关键洞察：你的业务逻辑、提示工程、消息格式都无需改变。迁移的全部工作就是更换 API 端点和 API 密钥。
5分钟迁移实战：Python 示例
假设你已经有一个基于 OpenAI API 的 Python 脚本，用于进行文本补全。
步骤 1：获取 Celedog API 密钥
访问 Celedog 控制台 并注册账号。在“API Keys”部分创建一个新的密钥。它将以 cldg- 开头。
步骤 2：修改代码中的两行配置
这是迁移的全部操作。我们以最简单的聊天补全调用为例。
迁移前（OpenAI）：
import openai
openai.api_key = "sk-your-openai-key" # 旧的 OpenAI 密钥
openai.api_base = "https://api.openai.com/v1" # 旧的端点
response = openai.ChatCompletion.create(
model="gpt-3.5-turbo",
messages=[
{"role": "system", "content": "You are a helpful assistant."},
{"role": "user", "content": "What is the capital of France?"}
]
)
print(response.choices[0].message.content)
迁移后（Celedog）：
import openai
# ✅ 唯一需要修改的部分
openai.api_key = "cldg-your-celedog-key" # 新的 Celedog 密钥
openai.api_base = "https://api.celedog.io/v1" # Celedog 的兼容端点
# 以下代码完全无需改动！
response = openai.ChatCompletion.create(
model="gpt-3.5-turbo", # 你仍然可以使用 OpenAI 模型
messages=[
{"role": "system", "content": "You are a helpful assistant."},
{"role": "user", "content": "What is the capital of France?"}
]
)
print(response.choices[0].message.content)
# 现在，你只需简单修改模型名称，即可切换到任何支持的模型
# 例如，切换为 Claude:
# response = openai.ChatCompletion.create(model="claude-3-sonnet", ...)
# 或切换为国内模型：
# response = openai.ChatCompletion.create(model="qwen-plus", ...)
核心修改总结：
- 将
openai.api_key的值替换为你的 Celedog 密钥。 - 将
openai.api_base的值替换为https://api.celedog.io/v1。 - 你的应用程序现在就拥有了访问 200+ 模型的能力！后续如需更换模型，只需在
model参数中更改模型标识符即可，无需再次改动基础配置。
更进一步：释放 Celedog 的全部潜力
迁移只是起点。完成上述步骤后，你可以立即开始利用 Celedog 的独特优势：
- 模型 A/B 测试：利用同一段代码，轻松地将
model参数从gpt-4改为claude-3-opus，对比不同模型在你的任务上的表现和成本。 - 成本优化：让应用默认使用性价比更高的模型（如
gpt-3.5-turbo），但对于复杂推理任务，动态切换到gpt-4或claude-3-opus。 - 地域合规与性能：对于国内用户，可以无感切换到通义千问（
qwen-plus）或文心一言模型，以获得更低的延迟和符合数据本地化的要求。 - 利用智能路由：在 Celedog 控制台中启用智能路由，让你的请求自动匹配到当前性价比最高的模型，真正实现迁移后的成本节约。
常见问题解答
问：我的应用中使用了 OpenAI 的流式输出（Streaming），迁移后还能用吗？
答：可以。Celedog 完全兼容 OpenAI 的流式请求格式和响应块（chunk）格式。只需修改端点和密钥，流式功能将正常工作。
问：API 密钥的安全管理有区别吗？
答：没有。你仍然需要在环境变量或安全的配置管理器中存储你的 Celedog 密钥（cldg-xxx），并遵循与管理 OpenAI 密钥相同的安全最佳实践。
问：如果我遇到问题，有技术支持吗？
答：当然。我们提供详尽的 API 文档 和技术支持渠道。大多数关于 OpenAI 兼容性的问题都能在文档中找到答案。
结语
将应用从单一的 OpenAI API 迁移到一个聚合、智能且成本优化的网关，不再是一项令人畏惧的工程。通过 Celedog 严格的 OpenAI 兼容设计，你可以在数分钟内完成切换，立即将全球 200+ 模型的威力注入你的应用。
我们邀请你亲身体验这一过程。从创建一个免费账户、生成密钥，到修改两行代码——感受前所未有的灵活性和控制力。
作者简介：
Celedog 技术内容团队致力于帮助开发者更高效地构建和优化 AI 应用。我们关注前沿的 AI 开发工具、API 技术以及工程实践，旨在提供清晰、实用的技术洞察。
About Celedog: Celedog is an AI Model API Aggregation Gateway.
Access 200+ models with a single API key. Smart routing saves 20-40% on API costs.
Multi-currency support (USD/CNY/IDR).
Try Free |
Read Docs
Top comments (0)