OpenAI 协议无缝迁移指南：5 分钟接入 30+ 国产大模型

如果你的项目已经在使用 OpenAI SDK，想切换到国产大模型（DeepSeek、GLM、Kimi、Qwen 等），最头疼的莫过于重写调用逻辑。唯元智创平台全面兼容 OpenAI 协议，你只需修改一行 base_url，即可零成本迁移。

本文手把手带你完成从 OpenAI 到国产大模型的无缝切换，全程不超过 5 分钟。

一、迁移原理

唯元智创的 API 网关完全遵循 OpenAI 的 API 标准规范，包括：

• 接口路径：/v1/chat/completions、/v1/embeddings、/v1/images 等完全一致
• 请求/响应格式：消息结构、流式输出（SSE）、Function Calling 全部兼容
• 认证方式：同样使用 Authorization: Bearer <api_key>

这意味着，任何基于 OpenAI SDK 或兼容 OpenAI 协议的客户端（如 LangChain、LlamaIndex、Chatbox 等），都可以直接指向唯元智创的端点。

二、准备工作

1. 获取 API Key

登录唯元智创控制台，进入 API Keys 页面，点击「创建密钥」：

https://weimeta.cn/console/api-keys/

你会得到一个形如 sk-xxxxxxxx 的密钥。请妥善保管，不要提交到代码仓库。

2. 确认 base_url

唯元智创的 API 端点：

https://api.weimeta.cn/v1

三、Python SDK 迁移

原 OpenAI 代码

from openai import OpenAI

client = OpenAI(
    api_key="sk-openai-xxx",
    base_url="https://api.openai.com/v1"
)

response = client.chat.completions.create(
    model="gpt-4o",
    messages=[
        {"role": "user", "content": "用 Python 写一个快速排序"}
    ]
)
print(response.choices[0].message.content)

迁移后（唯元智创）

from openai import OpenAI

client = OpenAI(
    api_key="sk-weimeta-xxx",          # 你的唯元智创 API Key
    base_url="https://api.weimeta.cn/v1"  # 仅修改这一行
)

response = client.chat.completions.create(
    model="glm-5.2",  # 切换为任意支持的模型
    messages=[
        {"role": "system", "content": "你是一个专业的 AI 助手。"},
        {"role": "user", "content": "用 Python 写一个快速排序"}
    ]
)
print(response.choices[0].message.content)

四、流式输出（SSE）

流式输出完全兼容，实时返回生成内容：

stream = client.chat.completions.create(
    model="deepseek-v4-flash",
    messages=[{"role": "user", "content": "讲一个程序员笑话"}],
    stream=True
)

for chunk in stream:
    if chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="", flush=True)

五、cURL 直接调用

如果你不使用 SDK，也可以用 cURL 直接调用：

curl https://api.weimeta.cn/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-weimeta-xxx" \
  -d '{
    "model": "glm-5.2",
    "messages": [
      {"role": "system", "content": "你是一个专业的 AI 助手。"},
      {"role": "user", "content": "用 Python 写一个快速排序"}
    ],
    "stream": false
  }'

六、Node.js SDK 迁移

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: "sk-weimeta-xxx",
  baseURL: "https://api.weimeta.cn/v1",
});

const completion = await client.chat.completions.create({
  model: "kimi-k3",
  messages: [{ role: "user", content: "你好，介绍一下你自己" }],
});

console.log(completion.choices[0].message.content);

七、Function Calling 与多模态

平台原生支持高级特性，调用方式与 OpenAI 完全一致：

• Function Calling：定义 tools 数组，模型自动决定是否调用函数
• 多模态输入：图像 + 文本混合输入（视觉模型）
• Embeddings：文本向量化，用于 RAG 检索

# Function Calling 示例
tools = [
    {
        "type": "function",
        "function": {
            "name": "get_weather",
            "description": "获取指定城市的天气",
            "parameters": {
                "type": "object",
                "properties": {
                    "city": {"type": "string", "description": "城市名称"}
                },
                "required": ["city"]
            }
        }
    }
]

response = client.chat.completions.create(
    model="glm-5.2",
    messages=[{"role": "user", "content": "深圳今天天气怎么样"}],
    tools=tools
)

八、可切换的模型列表

在唯元智创平台，model 参数可填以下任意值：

模型 ID	厂商	特点
glm-5.2	智谱	1M 上下文，双推理模式
deepseek-v4-flash	深度求索	极致性价比，¥1/M 输入
deepseek-v4-pro	深度求索	代码推理能力强
kimi-k3	月之暗面	2.8T MoE，原生视觉
minimax-m3	稀宇科技	原生多模态
qwen3.7-max	阿里通义	中文场景最优

九、迁移检查清单

• 替换 base_url 为 https://api.weimeta.cn/v1
• 替换 api_key 为唯元智创密钥
• 修改 model 参数为目标国产模型
• 测试流式输出与 Function Calling（如有使用）
• 在控制台查看调用量与消费明细

总结

通过 OpenAI 兼容协议，从 OpenAI 迁移到国产大模型只需改一行代码。唯元智创平台让你用一个 API Key 调用 30+ 顶尖模型，既能降低成本，又能根据业务场景灵活切换，实现真正的「模型自由」。