單一端點處理提示詞與腳本

基礎 URL 與驗證

使用基礎 URL https://api.stableaudio.top/v1 搭配任何標準的 OpenAI 相容用戶端。在 Authorization 標頭中以 Bearer YOUR_API_KEY 格式傳遞你的 API 金鑰。你可以在「取得 API 金鑰」頁面使用 Google 或電子郵件 + 密碼即時產生金鑰。每個帳戶僅支援一個有效金鑰；發行新金鑰將取代舊金鑰。該端點僅支援 POST /v1/chat/completions 與 GET /v1/models。此處不提供嵌入、影像、音訊或影片生成。這是用於你的音訊管線的純文字層。

發送您的第一個請求

發送標準聊天完成請求以生成文字。模型 ID 為 uncensored。這是一款開放權重模型，針對合法成人主題減少內容拒絕進行了調整。你可以調整 temperature 和 top_p 等參數。該模型擁有 100,000 token 的上下文視窗。每個回應最多可請求 32,000 token。定價透明：每 1M 輸入 token 為 $0.15，每 1M 輸出 token 為 $0.50。錯誤和拒絕不會消耗額度。

複製curl https://api.stableaudio.top/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."}]
  }'

Python SDK 整合

使用官方的 OpenAI Python SDK 將 API 整合至你的 Python 腳本中。在客戶端設定中設定 base_url 和 api_key。這讓你能夠利用已使用 OpenAI 介面的現有程式碼庫。客戶端會自動處理 JSON 序列化與回應解析。你可以串流回應或批次處理。此方法適用於提示詞生成、腳本撰寫，或從文字輸入中提取結構化資料以用於你的音訊工作流程。

複製from openai import OpenAI

client = OpenAI(base_url="https://api.stableaudio.top/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)

Node SDK 整合

使用 OpenAI Node SDK 將 API 整合至你的 Node.js 應用程式中。使用正確的 Base URL 和 API 金鑰設定客戶端。這確保了與標準 OpenAI 模式的相容性。你可以發出同步或非同步請求。用於網頁鉤子或背景作業中的即時文字處理。SDK 會處理重試邏輯與回應解析。這非常適合建構語音腳本或字幕管線，這些應用需要可靠且無審查的文字輸出，且無需訂閱費用。

複製import OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.stableaudio.top/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);

串流回應 (SSE)

透過在請求中設定 stream: true 來啟用串流功能。API 會傳回 Server-Sent Events (SSE)。Token 使用資訊包含在最後一個區塊中。這降低了長文字生成的感知延遲。用於即時字幕或互動式提示詞優化。模型 ID 仍為 uncensored。串流不會改變定價模式。你仍只需為實際生成的 token 付費。串流期間的錯誤會優雅處理，不會消耗額外額度。

複製stream = 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)

Token 限制與配額

該模型支援 100,000 token 的上下文視窗。每次請求的最大輸出為 32,000 token，若未設定 max_tokens 則為 2,048。每個金鑰每分鐘限 300 個請求。每個金鑰的並行請求上限為 8 個。請求主體不得超過 8 MB。若超過速率限制，你會收到 429 錯誤。若金鑰無效，你會收到 401 錯誤。若預付額度不足，你會收到 402 錯誤。錯誤和拒絕免費。額度永不過期。使用信用卡（Visa, Mastercard, Apple Pay, Google Pay）或加密貨幣（TRC20 上的 USDT、Base 上的 USDC）儲值，金額範圍為 $20 至 $500。