文件
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-...端點
| POST /v1/chat/completions | 相容 OpenAI 的聊天 |
| POST /v1/messages | 相容 Anthropic 的訊息 |
| 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 表示您已達到速率或支出上限,兩者都可在主控台中查看。