繁中 ▾
立即開始

幾分鐘內整合 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 金鑰

註冊帳號、取得金鑰、更新端點。所需努力極少。

立即開始