Whisper 管線快速上手

先決條件

開始之前，請確保你擁有有效的帳號與 API 金鑰。僅使用電子郵件與密碼在 取得 API 金鑰 頁面註冊。金鑰會立即顯示。你將獲得 $0.50 的免費試用額度，有效期 7 天，無需信用卡。用於生產環境時，可透過加密貨幣（USDT 或 USDC）從 $10 開始儲值。我們的定價很簡單：每 1M 輸入 token $0.25，每 1M 輸出 token $1.00。額度永不過期。

Base URL： https://api.whisperapis.com/v1。此端點可與任何 OpenAI 相容的客戶端搭配使用。你只需設定 Base URL 並在授權標頭提供 API 金鑰。基本 HTTP 請求不需要特殊的 SDK。

初始化客戶端

大多數開發者將使用官方的 OpenAI SDK 或相容函式庫。透過指向我們的 Base URL 來初始化客戶端。這可確保所有請求路由至我們的無審查模型，而非 OpenAI 的伺服器。模型 ID 始終為 uncensored。

確保你的環境變數 OPENAI_API_KEY 設定為來自儀表板的金鑰。如果你使用不同的語言或函式庫，請確認它支援自訂 Base URL。SDK 會為你處理 JSON 序列化與標頭注入，減少管線腳本中的样板程式碼。

發送聊天補全

發送標準的聊天補全請求以優化你的管線輸出。例如，從語音轉文字轉錄中提取結構化 JSON，或為影像生成不含內容審查的說明文字。

端點為 POST /v1/chat/completions。包含模型 ID、你的訊息陣列，以及可選的系統提示詞以定義無審查行為。

Copycurl https://api.whisperapis.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Write a blunt product review of a cheap VPN."}]
  }'

我們的模型能很好地處理高上下文資料，支援最多 100,000 token。這非常適合在單一處理階段中處理長篇轉錄內容或詳細的影像描述。

串流回應

對於即時後處理或互動式管線，請啟用串流輸出。在請求中將 stream 參數設定為 true。API 將傳回伺服器發送事件（SSE），而非單一 JSON 物件。

隨著資料到達，解析 delta 欄位。這可降低大型輸出的感知延遲，例如生成詳細腳本或從雜亂的 OCR 結果中提取長文本區塊。串流格式與標準 OpenAI SDK 的串流處理常式相容。

Copystream = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Tell the story in second person."}],
    stream=True,
)
for chunk in stream:
    if chunk.choices and chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="", flush=True)

確保你的客戶端能正確處理部分區塊。當串流以 finish_reason 為 stop 或 length 結束時，聚合這些 delta 以重建完整的文字回應。

工具呼叫支援

我們的無審查模型支援函式呼叫，允許你為管線定義結構化輸出。在 tools 陣列中使用 JSON schema 定義來定義你的工具。

模型會在回應中傳回工具呼叫，你可執行這些呼叫以更新對話上下文。這非常適合從未結構化文字中提取特定資料點，例如從語音轉錄中提取日期、名稱或座標。

Copyfrom openai import OpenAI

client = OpenAI(base_url="https://api.whisperapis.com/v1", api_key="YOUR_KEY")

resp = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Summarise this thread without softening it."}],
)
print(resp.choices[0].message.content)

在後續訊息中將工具呼叫傳回 API。模型將根據結果優化其輸出。這允許在不離開聊天介面的情況下進行複雜的多步驟推理。請確保你的 schema 嚴格，以避免產生格式錯誤的 JSON 回應。

限制、錯誤與上下文

監控你的使用情況以避免中斷。API 對每個金鑰實施 每分鐘 300 個請求 的限制。如果你超過此限制，會收到 429 速率限制錯誤。在你的客戶端實現指數退避。

常見錯誤：

• 401：無效或過期的 API 金鑰。請從儀表板重新生成金鑰。
• 402：額度不足。請為你的帳號儲值以繼續處理。
• 429：超過速率限制。降低請求頻率或將較小的任務分批處理。

上下文視窗： 該模型支援 100,000 token 的提示詞 + 補全。若輸入超過此限制，請截斷較舊的訊息或分割資料。請求主體限制為 8 MB。確保你的有效負載符合這些限制，以獲得可靠的效能。

Node.js

Copyimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.whisperapis.com/v1", apiKey: process.env.API_KEY });

const resp = await client.chat.completions.create({
  model: "uncensored",
  messages: [{ role: "user", content: "Draft a villain monologue for my game." }],
});
console.log(resp.choices[0].message.content);