5 分鐘內完成首次請求
幾分鐘內即可開始使用 Apertus 無審查 LLM API。此快速入門指南涵蓋身份驗證、基本請求以及使用 OpenAI 相容介面的串流輸出。
基礎 URL 與驗證
使用專屬基礎 URL https://api.apertus.top/v1 存取 API。該服務與 OpenAI 相容,因此你可以透過更新 base_url 並提供你的 API 金鑰來使用標準 SDK。在 取得 API 金鑰 頁面使用 Google 或電子郵件地址註冊。金鑰在建立後會立即顯示。每個帳戶僅有一個有效金鑰;產生新金鑰會取代舊金鑰。沒有月費訂閱或金鑰過期日期。預付額度永不過期,未使用的資金仍可用於未來的請求。錯誤和拒絕不會消耗你的額度。
首次請求
發送簡單的文本補全請求以測試連線與計費。使用模型 ID uncensored 存取單一開放權重模型。此模型經過調整,能在合法成人用途下無內容拒絕地回答。基礎 URL 為 https://api.apertus.top/v1。定價透明:每 1M 輸入 token 為 $0.25,每 1M 輸出 token 為 $1.00。你只需為實際使用的部分付費。
curl https://api.apertus.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."}]
}'
回應會返回生成的文字。如果你的額度不足,你將收到帳單錯誤。處理過程中的錯誤不會向你的帳戶收費。你可以透過儀表板使用 USDT (TRC20) 或 USDC (Base) 進行儲值。
Python SDK 整合
使用官方 OpenAI Python SDK 或任何相容的用戶端。將 base_url 設定為 https://api.apertus.top/v1 並提供您的 API 金鑰。這使您能夠利用為 OpenAI 設計的現有程式碼庫。端點 /v1/chat/completions 處理所有文本生成。模型 ID 為 uncensored。支援 temperature、top_p 和 stop 等參數。串流回應會在最後一個區塊包含 token 使用詳情。函式呼叫和 JSON 模式也可用於結構化輸出。
from openai import OpenAI
client = OpenAI(base_url="https://api.apertus.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 整合
使用 Apertus 基礎 URL 初始化用戶端。OpenAI 類別接受標準配置參數。傳遞您的 API 金鑰並將基礎 URL 設定為 https://api.apertus.top/v1。這確保與現有 Node.js 應用程式相容。uncensored 模型 ID 是所有請求所必需的。您可以使用 max_tokens 控制輸出長度。如果未指定,預設最大輸出為 2,048 token,每請求硬性上限為 32,000 token。
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.apertus.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);
串流回應
在請求中設定 stream: true 以啟用串流。API 會傳回伺服器發送事件 (SSE) 串流。每個區塊包含部分文字。最後一個區塊包含該請求的完整 token 使用統計數據。這使您能夠即時顯示結果並追蹤成本。串流支援所有參數,包括函式呼叫。確保您的用戶端能正確處理 SSE 事件。上下文視窗支援最多 100,000 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)
限制、錯誤與上下文
API 強制執行每支金鑰每分鐘 300 次請求的限制,並允許 8 次並行請求。最大請求主體大小為 8 MB。如果驗證金鑰無效,您會收到 401 錯誤。如果您的預付額度耗盡,您會收到 402 錯誤,表示資金不足。速率限制是基於每分鐘配額應用的。上下文視窗總共為 100,000 token。每請求的最大輸出為 32,000 token。超過此限制的請求由模型的標準行為處理。不保證任何 SLA 百分比。保持隱私;提示詞不會用於訓練。
API 技術參數
購買額度前,請先確認介面是否符合你的需求——以下是全部真實參數。
| 項目 | 說明 |
|---|---|
| 介面格式 | 相容 OpenAI:任何 OpenAI SDK 只需更換 base URL 和金鑰 |
| 端點 | POST /v1/chat/completions · GET /v1/models |
| Base URL | https://api.apertus.top/v1 |
| 模型 ID | uncensored |
| 驗證 | Authorization: Bearer YOUR_KEY |
| 函式呼叫 | 支援 tools、tool_choice;回覆包含 tool_calls(串流同樣支援),結果以 role: tool 訊息回傳 |
| 串流輸出 | 支援 SSE,最後一段包含 token 用量 |
| 最大輸出 | 不另設輸出上限;提示+回覆共 64,000 個 token 視窗內,max_tokens 可選 |
| 取樣參數 | temperature、top_p、stop、seed、presence_penalty、frequency_penalty |
| JSON 模式 | response_format: {"type": "json_object"} |
| 上下文視窗 | 64,000 tokens(輸入與輸出合計) |
| 速率限制 | 每把金鑰每分鐘 300 次請求 |
| 並行請求 | 每把金鑰同時最多 8 個請求 |
| 回應標頭 | X-Request-Id、X-Balance-USD、X-RateLimit-Limit-Requests、X-RateLimit-Limit-Concurrency |
| 請求大小 | 每次請求不超過 8 MB |
| 贈送額度 | 滿 $50 送 5%,滿 $100 送 10% |
| 免費試用 | $0.50,有效期 7 天,不需信用卡 · 試用金鑰:2 個並行請求,每分鐘 60 次;首次儲值後恢復完整限額(8 和 300) |
| 計費 | 預付額度,按實際 token 用量扣費;錯誤和拒絕不收費 |
| 儲值 | USDT(TRC20)或 USDC(Base),$10–$500 任意整數金額 |
| 額度效期 | 付費額度永不過期,無訂閱 |
| 價格 | 輸入 $0.25 / 百萬 tokens · 輸出 $1.00 / 百萬 tokens |
| 登入 | Google 或電子郵件 + 密碼 |
| 內容政策 | 允許成人內容;涉及未成年人的性內容一律拒絕 |
| 金鑰 | 每個帳戶一把有效金鑰;產生新金鑰後舊金鑰失效 |
錯誤代碼
錯誤以 JSON 回傳,type 欄位固定;失敗或被拒絕的請求不計費。
| 狀態碼 | 類型 | 含義 |
|---|---|---|
400 | bad_request | JSON 無效、訊息為空、參數錯誤或超出上下文視窗 |
401 | missing_key · invalid_key · key_revoked | 缺少金鑰、金鑰錯誤或已被新金鑰取代 |
402 | no_credit | 餘額不足——儲值後立即恢復 |
403 | content_blocked | 涉及未成年人的性內容——拒絕且不計費 |
404 | not_found | 未知端點 |
413 | request_too_large | 請求內容超過 8 MB |
429 | rate_limited · concurrency | 超過每分鐘 300 次或 8 個並行——稍後重試 |
503 | upstream_busy | 模型忙碌——幾秒後重試 |
問答
我的 API 金鑰會過期嗎?
不會,您的 API 金鑰不會過期。您的帳戶沒有月費或定期費用。您可以無限期使用金鑰,直到您選擇撤銷為止。
如果我達到速率限制會怎樣?
API 限制每支金鑰每分鐘 300 次請求。若超過此限制,後續請求可能會被延遲或拒絕。您同時可以進行 8 次並行請求。請監控您的使用量以保持在這些限制範圍內。
如果輸出超過 32,000 token 會被截斷嗎?
該模型支援每請求最多 32,000 token 的輸出。如果生成的文字超過此限制,模型會截斷回應。您可以調整 <code>max_tokens</code> 參數,在此限制內控制輸出長度。
只差一張表單,即可取得金鑰
建立帳戶、複製金鑰、更改基礎 URL。這就是整個設定。