繁中 ▾
取得 API 金鑰
為開發人員設計的 OpenAI 相容無審查 API。更新於

可複製執行的 LLM API curl 範例

如果你想在寫程式前先測試 LLM API,以下請求就足夠了。每個請求都指向相容 OpenAI 的端點,使用模型 ID uncensored,並且從純文字終端機執行。

終端機面板發射光束到伺服器方塊,代表發送到 LLM API 的 curl 請求

設定 shell 並檢查端點

從 API 金鑰頁面取得金鑰,然後匯出金鑰與基底 URL,避免在每個指令中貼上金鑰。

export API_KEY="paste-your-key-here"
export BASE="https://api.uncensoredllmapi.com/v1"

每個請求都會將金鑰作為 Bearer token 發送到 Authorization 標頭。請求主體是 JSON,所以 POST 時請加上 Content-Type: application/json。最大主體大小為 8 MB,這只有在將非常大的文件貼入提示詞時才有意義。

範例使用 Unix shell 的單引號。在 Windows PowerShell 上,請將 JSON 放入檔案並使用 --data @body.json 傳遞,以避免引號問題。

最便宜的健全性檢查是列出模型的 GET 請求。它確認金鑰與 URL,且不需要花費。

curl -s "$BASE/models" \
  -H "Authorization: Bearer $API_KEY"

回覆中的 data 陣列應包含 ID uncensored。401 表示金鑰遺失或輸入錯誤。如果 curl 完全無法連線,請檢查 $BASE 中的主機,並確保它以 /v1 結尾且沒有額外路徑。

1. 發送聊天完成請求

這是每個 OpenAI 風格客戶端在底層發送的請求。

curl -s "https://api.uncensoredllmapi.com/v1/chat/completions" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [
      {"role": "system", "content": "You are a concise assistant."},
      {"role": "user", "content": "Give me three names for a fantasy tavern."}
    ],
    "temperature": 0.8,
    "max_tokens": 200
  }'

回覆是 JSON。文字位於 choices[0].message.content,token 計數位於 usage。如果你已安裝 jq 且只想取得文字,請將輸出通過 jq -r '.choices[0].message.content'。max_tokens 欄位是選填的;省略它,補全結果可能會使用 100,000-token 上下文視窗中剩餘的任何內容。

如果你的客戶端使用該格式,也可以使用較新的 POST /v1/responses 端點。完整參數列表請參閱 文件。

2. 串流輸出答案

加上 "stream": true 並告訴 curl 不要緩衝,使用 -N。token 將在生成時列印。

curl -N "$BASE/chat/completions" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "stream": true,
    "messages": [{"role": "user", "content": "Count from one to ten in words."}]
  }'

每一行都以 data: 開頭,並包含一個帶有 delta 的小型 JSON 區塊。最後的事件帶有用量,串流以 data: [DONE] 結束。沒有 -N 時,curl 會等待完整緩衝區,輸出看起來像是一次性到達。注意,串流模式的請求會佔用一個並行請求槽位直到結束。

3. 要求 JSON

對於腳本將要解析的輸出,請使用 response_format 開啟 JSON 模式。在提示詞中提到 JSON 關鍵字,讓模型知道你所預期的格式。

curl -s "$BASE/chat/completions" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "response_format": {"type": "json_object"},
    "messages": [{"role": "user",
      "content": "Return JSON with keys name and level for a fantasy character."}]
  }' | jq -r '.choices[0].message.content | fromjson'

最終的 fromjson 過濾器會解析 content 內的字串,因此如果模型回傳的不是有效 JSON,jq 會發出明確錯誤。這使其成為一個方便的快速測試。更多模式請見 JSON 模式頁面。

4. 嘗試函式呼叫

函式呼叫讓模型要求你的程式碼執行函式。你在 tools 陣列中描述函式,如果模型決定使用它,回覆將包含 tool_calls 項目而非文字。

curl -s "$BASE/chat/completions" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "What is the weather in Oslo?"}],
    "tools": [{
      "type": "function",
      "function": {
        "name": "get_weather",
        "description": "Get current weather for a city",
        "parameters": {
          "type": "object",
          "properties": {"city": {"type": "string"}},
          "required": ["city"]
        }
      }
    }],
    "tool_choice": "auto"
  }' | jq '.choices[0].message.tool_calls'

你應該會得到函式名稱和參數的 JSON 字串。你的程式碼執行該函式,然後發送第二個請求,重複之前的訊息,加上帶有函式呼叫的助手訊息,並加上帶有 role: "tool" 的結果訊息。然後模型會寫出最終答案。

5. 檢查標頭與餘額

加上 -i 以查看回應標頭與主體。你會找到 X-Request-Id、X-Balance-USD、X-RateLimit-Limit-Requests 和 X-RateLimit-Limit-Concurrency。

curl -s -i "$BASE/chat/completions" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"uncensored","messages":[{"role":"user","content":"ping"}],"max_tokens":5}' \
  | grep -i "^x-"

curl -s "$BASE/balance" -H "Authorization: Bearer $API_KEY"

第二次呼叫會直接回傳你的額度。OpenAI 風格的工具可以使用 GET /v1/dashboard/billing/credit_grants 代替。像上面那樣微小的請求成本不到一美分:使用 10 個輸入 token 和 5 個輸出 token,價格為 10 x 0.15 / 1,000,000 + 5 x 0.50 / 1,000,000 = $0.000004。請參閱 定價頁面 查看費率。

可重複使用的冒煙測試腳本

一旦你信任個別呼叫,請將它們包裝成短腳本,以便在任何部署、金鑰輪換或網路變更後執行。它在第一個問題時失敗,因此你可以精確看到哪一步出錯。

set -euo pipefail
BASE="https://api.uncensoredllmapi.com/v1"

echo "models:"
curl -sf "$BASE/models" -H "Authorization: Bearer $API_KEY" | jq -r '.data[].id'

echo "chat:"
curl -sf "$BASE/chat/completions" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"uncensored","messages":[{"role":"user","content":"Say ok."}],"max_tokens":5}' \
  | jq -r '.choices[0].message.content'

echo "balance:"
curl -sf "$BASE/balance" -H "Authorization: Bearer $API_KEY"

-f 旗標使 curl 在 HTTP 失敗時退出並顯示錯誤,set -e 讓腳本在此停止。如果你在此 API 之上運行服務並希望在發生變更時獲得早期警告,請將其放入 cron 作業或 CI 步驟。將金鑰保存在秘密儲存庫或環境變數中,不要放在腳本檔案本身。

當變更請求時,一次嘗試一個設定:temperature 用於隨機性,top_p 用於核採樣法,stop 用於自訂結束序列,以及 seed 用於可重複輸出。它們都會傳遞給模型,因此你可以從相同的終端機歷史記錄比較它們的效果。

從 curl 讀取錯誤

狀態碼可能原因修復方法
401遺漏或錯誤的金鑰檢查 Authorization 標頭並確認 $API_KEY 已匯出
400JSON 格式錯誤或欄位錯誤發送前使用 jq . 驗證主體
429,程式碼 rate_limited每分鐘超過 300 個請求(試用金鑰為 60)減慢你的迴圈速度
429,程式碼 concurrency同時超過 8 個請求(試用金鑰為 2 個)執行較少的並行請求
429 帶有 Retry-After: 5暫時過載等待 5 秒後重試

加入 -w "\n%{http_code}\n" 可在回應主體之後列印狀態碼,避免你猜測。錯誤主體是包含訊息與代碼的 JSON,因此 jq .error 可清晰顯示它們。如果在迴圈中看到 429,不要立即重試;暫停幾秒鐘讓分鐘視窗和並行槽位清除,緊湊的重試迴圈只會讓你持續超過限制。試用金鑰的限制比完整金鑰更嚴格,因此在你首次儲值後能運作的腳本,如果在並行執行工作,可能會在試用額度上失敗。一旦請求運作正常,請轉向使用 SDK;相同的 URL 和模型名稱會原封不動地沿用。新帳戶可以一鍵領取 $0.50 的試用額度,足以進行數百次小型測試呼叫。此後的儲值從 $20 起,以加密貨幣支付(TRC20 上的 USDT 或 Base 上的 USDC)。

問答

curl 請求要發送到哪個 URL?

使用 https://api.uncensoredllmapi.com/v1 作為基底,然後根據需求加上 /chat/completions、/responses、/models 或 /balance。

如何用 curl 測試函式呼叫?

在聊天完成主體中加入包含函式定義的 tools 陣列。如果模型決定呼叫它,回覆會包含 tool_calls,而你則以 role 為 tool 的訊息將結果發送回去。

為什麼 curl 要等到回覆完成後才顯示內容?

你可能是沒有加上 -N 旗標進行串流輸出。加上 -N 讓 curl 在每個區塊到達時立即列印。

失敗的請求會扣款嗎?

不會。失敗或被拒絕的請求不會收費。

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

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