文档
Unify API 使用 OpenAI API 协议。如果你的代码已经在调用 OpenAI，只需更换 base URL 和密钥，其余一切保持不变。
快速开始
创建账户获取密钥，然后把客户端指向 https://api.unifyapi.ai/v1。
curl https://api.unifyapi.ai/v1/chat/completions \
-H "Authorization: Bearer $UNIFYAPI_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-5",
"messages": [{"role": "user", "content": "Hello"}]
}'使用现有 SDK
任何兼容 OpenAI 的客户端都可以用。设置 base URL 和你的 Unify API 密钥：
from openai import OpenAI
client = OpenAI(
api_key=os.environ["UNIFYAPI_KEY"],
base_url="https://api.unifyapi.ai/v1",
)
response = client.chat.completions.create(
model="gpt-5",
messages=[{"role": "user", "content": "Hello"}],
)Anthropic 风格的客户端可以改用 /v1/messages，使用同一个密钥。
身份验证
在每个请求中以 bearer token 的形式传递你的密钥。密钥在控制台中创建和吊销，每个密钥都可以限定到特定模型并设置自己的消费上限。
Authorization: Bearer sk-...Endpoint
| POST /v1/chat/completions | 兼容 OpenAI 的对话接口 |
| POST /v1/messages | 兼容 Anthropic 的 messages 接口 |
| POST /v1/responses | OpenAI Responses API |
| POST /v1/embeddings | 文本向量 |
| POST /v1/images/generations | 图像生成 |
| GET /v1/models | 列出你的密钥可用的模型 |
调用 GET /v1/models 可以准确查看你的密钥能访问哪些模型 — 这份列表对你的账户是权威的。
选择模型
在 model 字段中传入你的密钥有权访问的任意模型。Unify API 会把请求路由到该模型背后的供应商，并在供应商故障时自动切换，所以一个模型名在上游事故期间也能持续工作。
错误
错误遵循 OpenAI 的错误格式，现有的错误处理代码可以继续使用。401 表示密钥缺失或已吊销，429 表示你触发了速率或消费上限 — 两者都可以在控制台中查看。