開發者用的 Venice API 文件

驗證與 base URL

立即連線：將基礎 URL 設為 https://api.veniceapi.com/v1 並將您的 API 金鑰包含在 Authorization 標頭. 您透過 Google 或電子郵件註冊後即可立即取得此金鑰。單一模型即可處理所有文字生成，無需路由邏輯。您無需管理多個端點或代理設定。

保持您的金鑰安全。每個帳戶一次僅允許一個有效金鑰；生成新金鑰會使舊金鑰失效。這確保了 token 使用和計費的清晰歸屬。

聊天完成端點

將文字請求发送至 /v1/chat/completions 使用標準 HTTP POST 方法的 endpoint。API 接受包含模型名稱、系統指令和使用者訊息的 JSON 負載。

這是一個基本請求結構：

Copycurl https://api.veniceapi.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Check if the service blocks adult content in the test endpoint"}]
  }'

回應返回生成的文字、token 使用統計數據和完成標誌。您可以使用參數（如）調整行為。 temperature 或 top_p. 這些設定控制輸出的創意與隨機性。

錯誤回傳標準 HTTP 代碼。401 表示金鑰無效，402 表示信用額度不足。使用這些代碼在自動化工作流程中優雅地處理失敗。

Python SDK 整合

使用官方 OpenAI Python 程式庫與 uncensored LLM 互動。使用 Venice base URL 和您的 API 金鑰配置客戶端。此方法簡化了請求建構和回應解析。

Copyfrom openai import OpenAI

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

此方法可與為 OpenAI 設計的現有代碼庫無縫集成。您只需更改 base URL，無需大幅修改應用程式邏輯。庫會自動處理序列化和網絡連接。

請記住，模型 ID 必須設定為 uncensored. 這可確保您使用的是 Venice 提供的特定調校模型。其他模型可能不會表現出相同的行為模式。

Node SDK 整合

使用 OpenAI Node SDK 將 API 整合至 JavaScript 或 TypeScript 專案。設定 baseURL 至 Venice 端點並提供您的 API 金鑰。此設定支援同步與非同步操作。

Copyimport OpenAI from "openai";

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

此整合讓您能快速建構聊天機器人、內容生成器或資料擷取工具。SDK 管理請求生命週期，包括重試和錯誤處理。如果需要，您可以傳遞自訂標頭以用於進階用例。

請確保匯入正確版本的 SDK。較舊的版本可能不支援 Venice API 中的所有功能。請檢視文件以了解相容性詳細資訊。

透過 SSE 的串流回應

透過設定 stream 參數至 true. API 回傳伺服器發送事件（SSE）串流，而非完整的 JSON 物件。這允許您在 token 生成時顯示它們。

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)

串流可降低使用者的感知延遲。它非常適合聊天介面或即時儀表板。串流的最後一個區塊包含最終的 token 使用統計數據。請解析此數據以準確追蹤成本。

優雅地處理連線中斷。若串流中斷，您可以重試請求。若同時有多個串流處於活動狀態，API 無法保證順序。在高流量期間請密切監控您的速率限制。

錯誤處理與限制

API 的速率限制為每分鐘每金鑰 300 次請求。併發請求上限為每金鑰 8 次。請求主體不得超過 8 MB。超過這些限制將返回 429 Too Many Requests 錯誤。

上下文窗口大小為 100,000 tokens，包含提示和補合計。每次請求的最大輸出為 16,000 tokens。如果 max_tokens 未設定），預設限制為 2,048 個 token。請相應地規劃您的輸入，以避免截斷。

常見錯誤包括 401（無效金鑰）和 402（餘額不足）。處理這些代碼以提示用戶充值。對於計費問題請使用支援頁面。餘額永不過期，因此您可以稍後充值。