幾分鐘內整合 Venice AI API
將 Venice AI API 放入您現有的技術堆疊中,即可獲得無審查的回應,沒有通常的內容拒絕。
- 基礎 URL
https://api.veniceaiapi.com/v1- 模型
uncensored
基礎 URL 與驗證設定
API 位於 https://api.veniceaiapi.com/v1. 通過 Authorization 標頭。
透過 Google 或電子郵件註冊,即可立即獲得您的金鑰。無需電話號碼。透過設定基礎 URL,即可將金鑰與任何 OpenAI 相容的 SDK 搭配使用。
每個帳戶擁有一個有效金鑰。生成新金鑰會立即撤銷舊金鑰。這確保了簡易的存取控制,無需複雜的權限範圍。
您必須發送的模型 ID 為 "uncensored"。這是一個針對合法成人用途進行微調的開放權重模型,回答時不會進行內容審查。
- 基礎 URL:
https://api.veniceaiapi.com/v1 - Auth Header:
Authorization: Bearer YOUR_API_KEY - 模型:
uncensored
您可以使用簡單的 GET 請求測試連線性至 /v1/models. 這確認您的金鑰有效,然後再發送大量負載。
/v1/chat/completions 端點
將文字提示发送至 POST /v1/chat/completions 並接收文字回應。此端點處理所有標準聊天互動。
在 messages 陣列中包含 role 和 content 欄位。模型處理輸入並返回補全內容。您可以使用 max_tokens 參數。
預設最大輸出為 2,048 個 token。您可以將每次請求的輸出增加至 16,000 個 token。總上下文窗口允許提示詞和補全內容合計 100,000 個 token。
錯誤與拒絕不會消耗您的預付額度。這表示您只需為成功的 Token 生成付費。
模型參數:溫度、Top-P 和種子
使用標準 LLM 參數控制輸出的隨機性。設定 temperature 調整創意。較低的值使回應更具確定性和專注性。
使用 top_p 用於核採樣。這限制模型僅考慮頂部百分比的概率質量。它有助於防止重複或無意義的輸出。
設定 seed 用於獲得可重現的結果。這對於除錯或測試特定的提示詞變體很有用。您也可以使用 stop 序列以提前停止生成。
其他支援的參數包括 presence_penalty 和 frequency_penalty. 這些設定有助於管理長對話中的 token 多樣性。
調整這些設定以符合您的使用案例。角色扮演適合較高的 temperature,程式碼生成可能需要較低的值。
帶有伺服器發送事件 (SSE) 的串流回應
在請求主體中將 stream: true 在您的請求中。API 返回伺服器發送事件 (SSE),而非單一 JSON 物件。
每個區塊包含部分文字內容。這讓您可以即時向使用者顯示結果。這顯著改善了長回應的感知延遲。
最後一個區塊包含總 token 使用統計數據。您可以即時精確追蹤您的額度消耗情況。
優雅地處理串流錯誤。網路中斷可能會截斷回應。如有需要,您可以恢復或重試請求。
函式呼叫與 JSON 模式
使用函式呼叫將 API 整合到你的後端邏輯中。在你的請求中定義工具,模型將返回結構化的 JSON 參數。
設定 response_format: {"type": "json_object"} 以強制執行嚴格的 JSON 輸出。這非常適合將資料解析到您的應用程式中。
函式呼叫可與串流處理並行運作。您可以即時接收結構化資料。這使得複雜的多步驟互動成為可能。
該模型理解工具定義並據此執行。您在程式碼中處理工具執行的邏輯。
此功能使 API 適合用於建構代理程式或自動化工作流程。
速率限制與令牌限制
每個 API 金鑰的限額為每分鐘 300 次請求。您同時最多可擁有 8 個並行請求。這可防止突發流量使系統超載。
最大請求主體大小為 8 MB。確保您的有效負載在此限制內。大型上下文視窗會快速消耗此配額。
常見錯誤包括 401(無效金鑰)和 402(餘額不足)。429 錯誤表示您已達到速率限制。
信用額度無法退款。但重複扣款等錯誤可透過支援頁面修正。您的信用額度永不過期。
定價為每 1M 輸入 token 0.15 美元,每 1M 輸出 token 0.50 美元。僅接受加密貨幣充值,金額範圍為 20 美元至 500 美元。
cURL
curl https://api.veniceaiapi.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [{"role": "user", "content": "Return status as json"}]
}'Python
from openai import OpenAI
client = OpenAI(base_url="https://api.veniceaiapi.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)Node.js
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.veniceaiapi.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);串流
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)常見問題
Venice AI API 的上下文視窗為何,它如何影響效能?
提示與補全的總上下文視窗為 100,000 tokens,這允許進行長對話或文件處理。每次請求的最大輸出為 16,000 tokens。您可以透過 max_tokens 參數調整此限制。
如何在 API 中處理錯誤與拒絕?
錯誤不會消耗您的信用額。針對未成年人性內容等違法內容的拒絕是免費的。其他拒絕則取決於模型的調校。請檢查狀態碼以確認 401、402 或 429 錯誤。
我可以將 API 與 Vercel 或其他無伺服器平台搭配使用嗎?
是的,API 與 OpenAI 相容。您可以將其與任何 SDK 或框架整合。將 base URL 和 API 金鑰設定在環境變數中即可。它與 Vercel 模板及其他伺服器無函式運作良好。
保護您的 API 金鑰
註冊帳號、取得金鑰、更新端點。所需努力極少。