Skip to main content

​
从 OpenAI 迁移

由于 OmniaKey 完全兼容 OpenAI API，迁移只需两处修改：
  1. Base URL：改为 https://api.omniakey.com/v1
  2. API 密钥：使用 OmniaKey API 密钥

​
迁移前 (OpenAI)

from openai import OpenAI

client = OpenAI(
    api_key="sk-your-openai-key"
)

response = client.chat.completions.create(
    model="gpt-4o",
    messages=[{"role": "user", "content": "Hello!"}]
)

​
迁移后 (OmniaKey)

from openai import OpenAI

client = OpenAI(
    api_key="your-omniakey-api-key",
    base_url="https://api.omniakey.com/v1"  # 添加这行
)

response = client.chat.completions.create(
    model="gpt-4o",  # 相同的模型名
    messages=[{"role": "user", "content": "Hello!"}]
)
就这样！所有请求参数、响应格式、流式输出和错误处理都保持不变。

​
从 Azure OpenAI 迁移

Azure OpenAI 使用不同的 URL 格式和 API 版本。以下是切换方法：

​
迁移前 (Azure)

from openai import AzureOpenAI

client = AzureOpenAI(
    api_key="your-azure-key",
    api_version="2024-02-15-preview",
    azure_endpoint="https://your-resource.openai.azure.com"
)

response = client.chat.completions.create(
    model="gpt-4o",  # 部署名称
    messages=[{"role": "user", "content": "Hello!"}]
)

​
迁移后 (OmniaKey)

from openai import OpenAI  # 使用标准 OpenAI 客户端

client = OpenAI(
    api_key="your-omniakey-api-key",
    base_url="https://api.omniakey.com/v1"
)

response = client.chat.completions.create(
    model="gpt-4o",  # 使用标准模型名
    messages=[{"role": "user", "content": "Hello!"}]
)

​
从直接调用供应商 API 迁移

如果你直接调用 Anthropic、Google 等供应商，OmniaKey 提供统一接口：

​
迁移前 (多个 SDK)

# Anthropic
import anthropic
claude_client = anthropic.Anthropic(api_key="sk-ant-xxx")
claude_response = claude_client.messages.create(
    model="claude-3-5-sonnet-20241022",
    max_tokens=1024,
    messages=[{"role": "user", "content": "Hello!"}]
)

# Google
import google.generativeai as genai
genai.configure(api_key="your-google-key")
gemini = genai.GenerativeModel("gemini-2.0-flash")
gemini_response = gemini.generate_content("Hello!")

​
迁移后 (单一 SDK)

from openai import OpenAI

client = OpenAI(
    api_key="your-omniakey-api-key",
    base_url="https://api.omniakey.com/v1"
)

# 通过同一接口访问所有模型
claude_response = client.chat.completions.create(
    model="claude-3-5-sonnet",
    messages=[{"role": "user", "content": "Hello!"}]
)

gemini_response = client.chat.completions.create(
    model="gemini-2.0-flash",
    messages=[{"role": "user", "content": "Hello!"}]
)

​
兼容性对照

功能状态
对话补全完全兼容
流式输出 (SSE)完全兼容
函数/工具调用完全兼容
图像生成完全兼容
视频生成扩展 API
响应格式 (JSON 模式)完全兼容
嵌入模型即将推出
语音/TTS即将推出

​
迁移清单

1

获取 OmniaKey API 密钥

在 omniakey.com 注册，然后在控制台生成 API 密钥。
2

更新 base URL 和 API 密钥

将客户端初始化改为使用 https://api.omniakey.com/v1 作为 base URL，并使用你的 OmniaKey API 密钥。
3

验证模型名称

大多数模型名称直接可用。如果遇到问题，请查看支持的模型页面。
4

测试集成

运行现有的测试套件。由于 API 完全兼容，一切应该无需修改即可正常工作。
5

在控制台监控

使用控制台实时监控用量、延迟和费用。

​
需要帮助？

如果在迁移过程中遇到任何问题，请联系我们：