繁中 ▾
取得 API 金鑰

OpenAI 風格 API,搭配 cURL 與 Bearer Token

要從命令列呼叫 OpenAI 風格 API,你需發送帶有 Authorization 標頭的 HTTP POST,其中包含你的 token。本頁提供此 API 各項功能的可用 cURL 指令,以及失敗時的檢查步驟。

更新於

終端機視窗透過光纖傳送金鑰與資料封包至伺服器

重點摘要

  • token 放在標頭 Authorization: Bearer YOUR_KEY 中,模型 ID 為 uncensored。
  • 存在兩個端點:GET /v1/models 與 POST /v1/chat/completions。
  • 加入 -N 並設定 stream true 即可看到 token 透過 server-sent events 到達。
  • 使用 curl -i 讀取 X-Balance-USD 與速率限制標頭;429 代表等待並重試。

最小請求

以下是對此服務執行 open ai api curl with token 的最簡方式。將金鑰放入環境變數,避免它出現在您的殼層歷史記錄中,然後發送聊天訊息:

export UF_KEY="paste-your-key-here"

curl https://api.unfilteredaimodels.com/v1/chat/completions \
  -H "Authorization: Bearer $UF_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [
      {"role": "user", "content": "Explain what a bearer token is in two sentences."}
    ]
  }'

回應是 OpenAI 聊天完成格式的 JSON。答案位於 choices[0].message.content,而 usage 物件顯示提示詞與完成 token。指令的每個部分都有特定用途:

  • Authorization: Bearer ... 攜帶 token。「Bearer」是機制名稱;持有 token 者即視為其擁有者,這就是為什麼你要將它放在公開儲存庫之外。
  • Content-Type: application/json 告訴伺服器如何讀取主體。若沒有它,請求通常會因主體解析錯誤而失敗。
  • model 必須是 uncensored,此 API 提供的唯一模型。
  • messages 是一個物件列表,包含 role(system、user、assistant 或 tool)與 content。

要取得金鑰,請使用 Google 或電子郵件與密碼註冊,然後使用 API 金鑰頁面。新用戶可以一鍵領取 $0.50 的試用額度:無需信用卡,有效期 7 天,每人限領一次。

使用 GET /v1/models 檢查金鑰

在除錯長請求之前,先用最便宜的呼叫確認 token 是否有效。列出模型不花錢,並可顯示 URL、標頭和金鑰是否都正確。

curl -s https://api.unfilteredaimodels.com/v1/models \
  -H "Authorization: Bearer $UF_KEY"

良好的回答是一個包含 uncensored 的 JSON 清單。如果你已安裝 jq,請將輸出內容透過管道傳輸以僅提取 ID:

curl -s https://api.unfilteredaimodels.com/v1/models \
  -H "Authorization: Bearer $UF_KEY" | jq -r '.data[].id'

如果沒有收到有用的內容,請依序檢查以下列表,因為原因已按發生頻率列出:

  1. 變數為空。執行 echo "${UF_KEY:0:6}" 以查看前幾個字元,而不列印整個金鑰。
  2. 標頭拼寫錯誤,或金鑰前缺少 "Bearer"。
  3. 文件或聊天客戶端的彎曲引號替換了指令中的直引號。
  4. Base URL 錯誤。應為 https://api.unfilteredaimodels.com/v1,前面帶有 api.,後面帶有 /v1。
  5. 金鑰複製時帶有尾隨空格或換行符。

讀取回應標頭

加入 -i 以在輸出中包含標頭,或 -D - 以列印標頭同時保持主體乾淨:

curl -s -D - -o /dev/null \
  https://api.unfilteredaimodels.com/v1/chat/completions \
  -H "Authorization: Bearer $UF_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"uncensored","max_tokens":5,"messages":[{"role":"user","content":"ping"}]}'

有四個值得了解的回應標頭:

標頭含義
X-Request-Id此請求的識別碼。若聯繫支援,請引用此識別碼。
X-Balance-USD你剩餘的預付額度。
X-RateLimit-Limit-Requests你的金鑰每分鐘允許的請求數。
X-RateLimit-Limit-Concurrency你的金鑰允許的並行請求數。

完整金鑰的限制為每分鐘 300 個請求與 8 個並行請求,試用金鑰則為每分鐘 60 個請求與 2 個並行請求。上述請求將 max_tokens 設為 5,僅為了讓測試保持精簡。一般使用中 max_tokens 為選填,補完內容可使用提示詞佔用 100,000-token 上下文視窗後剩餘的任何額度。

從命令列進行串流輸出

設定 "stream": true 並加上 -N,讓 curl 不要緩衝輸出。你會看到以 data: 開頭的行,每行攜帶一個小型 JSON delta,以及最後的 data: [DONE]。它之前的區塊包含 token 使用量。

curl -N https://api.unfilteredaimodels.com/v1/chat/completions \
  -H "Authorization: Bearer $UF_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "stream": true,
    "messages": [{"role": "user", "content": "Write a four-line poem about a cron job."}]
  }'

要僅列印文字,請使用短管線過濾串流輸出:

curl -sN https://api.unfilteredaimodels.com/v1/chat/completions \
  -H "Authorization: Bearer $UF_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"uncensored","stream":true,"messages":[{"role":"user","content":"Count to five."}]}' \
  | sed -u 's/^data: //' | grep -v '^\[DONE\]' | grep -v '^$' \
  | jq -rj '.choices[0].delta.content // empty'
echo

串流請求會佔用其並行槽位,直到串流結束。如果你在腳本中同時啟動許多串流卻忘記讓它們完成,即使請求速率很低,你也會達到並行限制。

JSON 模式與工具呼叫

JSON 模式讓模型回傳單一有效的 JSON 物件。你也需在提示詞中說明想要的結構,否則鍵名將由模型自行決定。

curl -s https://api.unfilteredaimodels.com/v1/chat/completions \
  -H "Authorization: Bearer $UF_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "response_format": {"type": "json_object"},
    "messages": [
      {"role": "user", "content": "Return JSON with keys city and country for the capital of Portugal."}
    ]
  }' | jq -r '.choices[0].message.content'

工具呼叫使用標準的 tools 和 tool_choice 欄位。模型以 tool_calls 陣列回應,而非文字;你自行執行函式並將結果作為帶有 role: "tool" 和對應 tool_call_id 的訊息傳回。

curl -s https://api.unfilteredaimodels.com/v1/chat/completions \
  -H "Authorization: Bearer $UF_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "tool_choice": "auto",
    "tools": [{
      "type": "function",
      "function": {
        "name": "get_weather",
        "description": "Get current weather for a city",
        "parameters": {
          "type": "object",
          "properties": {"city": {"type": "string"}},
          "required": ["city"]
        }
      }
    }],
    "messages": [{"role": "user", "content": "What is the weather in Lisbon?"}]
  }'

在回覆中,尋找 choices[0].message.tool_calls[0].function.arguments。這是一個你需要解析的 JSON 字串,用它呼叫你自己的天氣函式,並在下一個請求中傳回。參數如 temperature、top_p、stop、seed 以及懲罰係數都會通過。文件列出了所有支援的欄位。

保護 token 安全,保持指令整潔

Bearer Token 是一種密碼,只是名稱不同。任何擁有它的人都可以使用你的額度,因此請像對待密碼一樣小心。不要將真實金鑰貼到公開議題、截圖或共用終端機記錄中。若懷疑金鑰外洩,請從金鑰頁面更換並更新腳本。

殼層歷史是個人電腦上最常見的洩漏途徑。直接在指令中輸入金鑰會將其存入歷史檔案。使用 export 設定一次仍會儲存該行。兩個更乾淨的習慣可幫助避免此問題。從僅你能開啟的檔案讀取金鑰,或在指令前加上空白(如果你的殼層設定為忽略以空白開頭的行)。一個小檔案即可達到此效果:

mkdir -p ~/.config/uf
printf '%s' 'paste-your-key-here' > ~/.config/uf/key
chmod 600 ~/.config/uf/key

export UF_KEY="$(cat ~/.config/uf/key)"

長 JSON 主體在單引號內難以閱讀,且一旦提示詞本身包含撇號,引號就會失效。將主體放入檔案,並讓 curl 使用 -d @file 讀取它:

cat > request.json <<'JSON'
{
  "model": "uncensored",
  "temperature": 0.3,
  "messages": [
    {"role": "system", "content": "You answer in plain language."},
    {"role": "user", "content": "What's the difference between a 401 and a 403 status code?"}
  ]
}
JSON

curl -s https://api.unfilteredaimodels.com/v1/chat/completions \
  -H "Authorization: Bearer $UF_KEY" \
  -H "Content-Type: application/json" \
  -d @request.json | jq -r '.choices[0].message.content'

相同的方法可讓大型提示詞在 8 MB 主體限制內保持易於管理,且檔案可在 Git 中進行版本控制,同時金鑰保留在儲存庫之外。在 Windows PowerShell 中,JSON 周圍的單引號行為不同,且不存在反斜線換行符號;-d @request.json 形式可避免這兩個問題,你可以使用行末的反引號來繼續指令。

測試結束後,請轉向使用 SDK。OpenAI Python 與 Node 函式庫接受相同的 Base URL 與金鑰,為你處理重試與串流輸出,並讀取你在此手動解析的相同回應格式。cURL 指令仍是檢查失敗是否來自你的程式碼或請求本身的最快方式,因此請在筆記中保留一個已知正常的 cURL 指令。當向支援團隊回報問題時,請包含失敗呼叫的 X-Request-Id 與確切的狀態碼;這組資訊能讓支援人員找到請求,無需你重複測試,也能節省來回溝通的時間。

錯誤、重試與每次呼叫的成本

當你超過限制時,API 會回傳 HTTP 429。錯誤碼會告知是哪個限制:rate_limited 表示每分鐘請求過多,concurrency 表示同時請求過多。暫時過載也會回傳 429 並加上 Retry-After: 5。curl 可針對暫時性錯誤自行重試:

curl --retry 3 --retry-delay 5 --retry-all-errors \
  https://api.unfilteredaimodels.com/v1/chat/completions \
  -H "Authorization: Bearer $UF_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"uncensored","messages":[{"role":"user","content":"Hello"}]}'

同時請將主體保持在 8 MB 以下,這在你將檔案編碼為提示詞時尤其重要。

失敗或拒絕的請求不會收費。成功的請求遵循簡單公式:每 1M 輸入 token 為 $0.15,每 1M 輸出 token 為 $0.50。一次包含 40 個輸入 token 和 120 個輸出 token 的測試呼叫成本為 40 / 1,000,000 x $0.15 = $0.000006 加上 120 / 1,000,000 x $0.50 = $0.00006,總計 $0.000066。一千次這樣的請求總計 $0.066。

額度是預付的,且永不過期。儲值金額從 $20 到 $500 的整數,從 $50 起有 5% 的獎勵,從 $100 起有 10% 的獎勵,從 $200 起有 15% 的獎勵,可透過加密貨幣(TRC20 上的 USDT、Base 上的 USDC)進行。定價頁面顯示詳細資訊。如果回應看起來不正確,迷思與事實頁面 解釋了模型能做什麼與不能做什麼。

問答

只差一個表單,即可取得金鑰

建立帳號、複製金鑰、更改基礎 URL。這就是整個設定過程。

token 在 cURL 指令中放哪裡?
    放在標頭中:-H "Authorization: Bearer YOUR_KEY"。請求主體也需要 Content-Type: application/json 標頭。
我該使用哪個模型名稱?
    使用 uncensored。你可以透過 GET /v1/models 來確認。
為什麼會收到 429?
    你達到了限制。rate_limited 程式碼代表每分鐘請求過多,concurrency 代表同時請求過多。等待幾秒鐘,或降低並行請求的數量。
如何查看剩餘額度?
    每個回應都包含 X-Balance-USD 標頭。使用 curl -i 或 curl -D - 列印標頭。
這是官方的 OpenAI API 嗎?
    不是。這是一個獨立的 OpenAI 相容服務,運行一個開放權重模型,因此為 OpenAI 格式構建的 SDK 和 cURL 指令在更改 Base URL 和金鑰後即可使用。