Venice AI API：五分鐘內完成首次請求

Base URL 與驗證

請先在取得 API 金鑰頁面建立帳戶。你只需要電子郵件和密碼；無需信用卡即可獲得有效期為七天的 0.50 美元試用額度。註冊完成後會立即顯示你的 API 金鑰，且可隨時重新產生，屆時舊金鑰將失效。

使用基礎 URL https://api.veniceapialternative.com/v1 搭配官方 OpenAI SDK 或任何與 OpenAI 相容的用戶端。將你的 API 金鑰設定為 Authorization 標頭中的 Bearer token。此 venice ai api 端點取代了你用戶端設定中的預設 OpenAI 基礎 URL。

首次請求

發送簡單的聊天補全請求以測試連線。模型 ID 始終為 uncensored。此開放權重模型運行於我們的 GPU 伺服器上，針對合法成人用途調整為無內容拒絕地回答。

將 YOUR_API_KEY 替換為你的實際金鑰。回應會根據你的提示詞傳回文字輸出。

Copycurl https://api.veniceapialternative.com/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 函式庫並設定其使用我們的 base URL。這讓你能夠利用預期 OpenAI 端點的現有程式碼庫。

Copyfrom openai import OpenAI

client = OpenAI(base_url="https://api.veniceapialternative.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 SDK 範例

對於 Node.js 環境，請使用 openai 套件。使用自訂 base URL 和你的 API 金鑰初始化客戶端。這確保所有請求都路由至 venice ai api 基礎設施。

Copyimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.veniceapialternative.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: true 以啟用串流輸出。API 會傳回 Server-Sent Events (SSE) 以即時交付 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)

速率限制與限制條件

uncensored 模型支援 100,000 token 的上下文視窗，用於提示詞和補全合計。每個 API 金鑰每分鐘限制 300 次請求。請求主體不得超過 8 MB。

常見錯誤包括 401（金鑰無效）、402（額度不足）和 429（超過速率限制）。從 $10 起儲值預付額度；額度永不過期。沒有月訂閱鎖定你的用量。