Unify API

文件

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/responsesOpenAI Responses API
POST /v1/embeddings文字嵌入
POST /v1/images/generations圖片生成
GET /v1/models列出您的金鑰可使用的模型

呼叫 GET /v1/models 即可確切查看您的金鑰能使用哪些模型,這份清單即為您帳號的準據。

選擇模型

在 model 欄位中傳入您的金鑰有權使用的任一模型。Unify API 會將請求路由到其背後的供應商,並在該供應商服務品質下降時自動容錯移轉,因此即使上游發生事故,同一個模型名稱仍可持續運作。

錯誤

錯誤格式與 OpenAI 相同,因此現有的錯誤處理可以照常運作。401 表示金鑰遺漏或已撤銷,429 表示您已達到速率或支出上限,兩者都可在主控台中查看。

準備好發出第一個呼叫了嗎?

建立帳號後即可馬上取得金鑰。

取得 API 金鑰