OpenAI 相容 API 金鑰:取得並發送呼叫
OpenAI 相容 API 金鑰是一個普通的 Bearer token,只要將用戶端指向不同的 Base URL,即可與任何 OpenAI SDK 搭配使用。本頁說明如何在此網站的託管文字 API 取得金鑰,並在幾分鐘內完成有效的請求。
更新Speech To Text API

金鑰的實際性質
"OpenAI 相容"描述的是 HTTP API 的格式,而非背後的公司。該服務接受與 OpenAI SDK 相同的 JSON 主體,於 POST /v1/chat/completions 處,並讀取相同的 Authorization: Bearer 標頭。因此,此服務的金鑰可嵌入任何允許設定自訂 Base URL 和 API 金鑰的工具:官方 Python 和 Node 庫、LangChain、純 curl 以及大多數桌面聊天客戶端。
此金鑰並非 OpenAI 金鑰,無法在 api.openai.com 上使用。反之亦然:OpenAI 金鑰也無法在此使用。每支金鑰僅屬於單一服務,此服務運行單一開放權重模型,針對合法成人用途調整為無審查回答,由獨立供應商託管。它並非任何模型供應商的官方 API,也不會將請求路由至其他供應商。
您需要記住的是:此網站的 Base URL 為 https://api.speechtotextapis.com/v1。模型 ID 為 uncensored。金鑰是您在註冊後獲得的任何字串。以下內容都是這三個值的變體。
該服務僅支援文字。它處理聊天完成、串流、工具呼叫和 JSON 模式。它不生成圖片或音訊,不提供嵌入,也不微調模型。如果您是從語音管線來到這裡,典型的工作是轉錄後的文字步驟:清理轉錄內容、將其拆分為場景、重寫對話或提取結構化資料。語音腳本處理指南更詳細地介紹了這方面內容。
透過四個步驟取得金鑰
- 註冊。 使用 Google,或使用電子郵件地址與密碼註冊。
- 開啟 API 金鑰頁面。 它位於此網站的 金鑰頁面。您的金鑰在此創建並顯示。
- 領取試用額度。 同一頁面上的按鈕可讓您一鍵獲得 $0.50 試用額度。每人限領一次,有效期 7 天,無需信用卡。
- 將金鑰複製到秘密儲存區。 對於本地測試,環境變數就足夠了。對於任何部署,請使用主機的機密管理器。
試用旨在證明整合在付費前即可運作。以目前價格,它足以處理許多短請求,下方的成本部分展示了計算方式。準備好繼續時,定價頁面 列出了儲值金額。額度為預付額度,無訂閱制,且額度永不過期,因此您無需在截止日期前花費儲值金額。
試用金鑰的限制比完整金鑰更嚴格:2 個並行請求和每分鐘 60 個請求。這足以運行第一個腳本。如果您計劃並行分發數十個轉錄片段,請預期會達到限制,直到您轉向已儲值的帳戶。
每個用戶端都會要求的三個設定
無論您使用什麼軟體,設定畫面都會以稍微不同的名稱要求相同的三項內容。
| 設定 | 典型欄位名稱 | 說明 |
|---|---|---|
| 端點 | Base URL、API base、host | https://api.speechtotextapis.com/v1 |
| 憑證 | API 金鑰、token、secret | 來自金鑰頁面的金鑰 |
| 模型 | 模型、模型名稱、engine | uncensored |
一個細節常讓人困惑:Base URL 已經以 /v1 結尾。SDK 會自行附加 /chat/completions,因此您不應添加它。如果您的客戶端要求聊天端點的完整 URL 而非 Base URL,則值為 https://api.speechtotextapis.com/v1/chat/completions。
如果工具僅提供具有硬編碼 host 且無法編輯的 "OpenAI" 預設值,則無法與此服務通訊。尋找 "custom"、"OpenAI-compatible" 或 "advanced" 選項,以暴露 Base URL 欄位。
你的首次請求
從 curl 開始,因為它能移除您與 API 之間的所有層級。將 YOUR_KEY 替換為您複製的金鑰。
curl https://api.speechtotextapis.com/v1/chat/completions \
-H "Authorization: Bearer YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [
{"role": "system", "content": "You clean up raw transcripts. Keep the meaning, fix punctuation."},
{"role": "user", "content": "so um we shipped the the beta on tuesday and uh nobody complained"}
]
}'
成功的回應是一個包含 choices 陣列的 JSON 物件。文字位於 choices[0].message.content,usage 區塊會報告您被計費的 token。
使用官方 Python 庫的相同呼叫如下所示。只有 base_url 和 api_key 與標準 OpenAI 設定不同。
import os
from openai import OpenAI
client = OpenAI(
base_url="https://api.speechtotextapis.com/v1",
api_key=os.environ["API_KEY"],
)
resp = client.chat.completions.create(
model="uncensored",
messages=[
{"role": "system", "content": "You clean up raw transcripts. Keep the meaning, fix punctuation."},
{"role": "user", "content": "so um we shipped the the beta on tuesday and uh nobody complained"},
],
)
print(resp.choices[0].message.content)
在 Node 中,使用相同的套件:
import OpenAI from "openai";
const client = new OpenAI({
baseURL: "https://api.speechtotextapis.com/v1",
apiKey: process.env.API_KEY,
});
const resp = await client.chat.completions.create({
model: "uncensored",
messages: [
{ role: "user", content: "Rewrite this in plain English: the beta shipped on Tuesday." },
],
});
console.log(resp.choices[0].message.content);
您不需要設定 max_tokens。當省略時,完成可以使用提示詞之後剩餘的 100,000-token 視窗中的任何內容。如果您想對每次呼叫的成本設定硬性上限,請自行設定。
檢查金鑰是否運作且不消耗 token
在將金鑰接入更大的系統之前,對 models 端點進行一次廉價呼叫。這可以確認金鑰被接受且 Base URL 正確。
curl -i https://api.speechtotextapis.com/v1/models \
-H "Authorization: Bearer YOUR_KEY"
-i 標記會列印回應標頭,該 API 在此報告有用的狀態:
X-Request-Id標識請求。如果您就特定呼叫聯繫 支援,請包含它。X-Balance-USD顯示帳戶的剩餘信用額度。X-RateLimit-Limit-Requests與X-RateLimit-Limit-Concurrency顯示適用於您金鑰的限制,讓您可以一眼看出該金鑰是試用限制還是完整限制。
在你的程式碼中讀取 X-Balance-USD 是一種廉價的預警方式,可在額度耗盡前通知你。如果你不希望產生雜訊輸出,請在每個工作階段記錄一次,而非每個請求記錄一次。
金鑰的使用成本
取得金鑰無需費用。你需為 token 付費:輸入 token 每 100 萬個 $0.15,輸出 token 每 100 萬個 $0.50,費用從預付額度中扣除。失敗或被拒絕的請求不會計費。
上述轉錄清理呼叫的實作範例。假設提示詞為 1,000 個 token,清理後的回應為 500 個 token。
- 輸入:1,000 / 1,000,000 x $0.15 = $0.00015
- 輸出:500 / 1,000,000 x $0.50 = $0.00025
- 總計:每次請求 $0.0004
因此,$0.50 的試用額度約可涵蓋 1,250 次該大小的呼叫($0.50 / $0.0004)。你的實際數值會有所不同,因為轉錄內容長度不一,但方法相同:計算輸入 token 數量、計算輸出 token 數量並相乘。
當您儲值時,接受 $20 至 $500 之間的任意整數金額。較大的儲值額享有額外贈額:$50 起贈 5%、$100 起贈 10%、$200 起贈 15%。例如,$100 的儲值會給你 $110 的信用額度。你可以使用加密貨幣(TRC20 上的 USDT、Base 上的 USDC)付款。
保護金鑰安全
API 金鑰是你餘額的密碼。任何擁有它的人都可以花費你的額度,因此請以此方式對待它。
- 不要將其提交至原始碼控制。請從環境變數或密鑰管理員中讀取它。
- 不要將金鑰打包在瀏覽器 JavaScript 或行動應用程式套件中。任何在用戶裝置上執行的程式碼都可能被檢查。在你的前端與 API 之間放置一個小型伺服器,並讓伺服器新增標頭。
- 不要將金鑰貼到螢幕截圖、票證或聊天訊息中。
- 如果你認為金鑰已洩漏,請立即停止使用並聯繫支援團隊,不要等待觀察是否發生問題。
關於隱私:傳送至 API 的提示詞不會用於訓練。這是關於服務的聲明,而非讓你發送不必要機密資料的理由。若任務不需要,請從轉錄內容中刪除個人資料。
當請求失敗時
大多數第一天的問題來自以下四種原因之一。
Base URL 錯誤
兩個常見的錯誤是缺少 /v1 以及重複的 /chat/completions。請將你的值與上表中的值逐字元比較。
金鑰包含多餘字元
從網頁複製時,通常會帶上尾端的空白字元或換行符號。請在程式碼中修剪該值,並檢查標頭是否讀作 Bearer(一個空白字元),接著是金鑰。
模型名稱不是 uncensored
客戶端通常會預設為其他模型名稱。請在每次呼叫時明確設定模型。
HTTP 429
有兩種類型,錯誤碼可將它們區分開來。rate_limited 表示你每分鐘發送的請求過多。concurrency 表示同時進行中的請求過多。串流請求會佔用其並行槽位,直到串流結束為止,因此即使請求速率很低,讀取速度過慢也可能導致此錯誤。帶有 Retry-After: 5 標頭的 429 狀態碼表示服務暫時過載;等待五秒後重試。在客戶端中使用短指數退避演算法可處理所有三種情況。
如需完整的參數列表、串流格式和函式呼叫詳細資訊,請參閱 API 文件。
更多指南
問答
這與 OpenAI 金鑰相同嗎?
不相同。它遵循相同的請求格式,因此 OpenAI SDK 可與之搭配使用,但它由本服務發行,且僅適用於此服務的 Base URL。
取得金鑰需要信用卡嗎?
否。使用 Google 或電子郵件註冊,然後在金鑰頁面點擊一次即可領取 $0.50 免費試用額度。該試用不需要信用卡,有效期為 7 天。
我應該使用哪個模型名稱?
在模型欄位中使用 uncensored。呼叫 GET /v1/models 將列出該金鑰可存取的內容。
我可以在多個伺服器上使用同一個金鑰嗎?
是的,但限制適用於整支金鑰:完整金鑰為 8 個並行請求和每分鐘 300 個請求,試用金鑰為 2 個和每分鐘 60 個。
金鑰可用於圖片或語音嗎?
不行。該 API 僅支援文字。它不會生成或轉錄音訊或圖片,也沒有嵌入或微調功能。