https://api.serverlessllmapi.com/v1
API 文件:快速入門
幾分鐘內即可開始使用無伺服器 LLM API。此快速入門指南涵蓋認證、聊天請求、串流輸出及工具呼叫,適用於我們的 OpenAI 相容介面。
Base URL 與認證
無伺服器 LLM API 使用標準的 OpenAI 相容端點結構。要開始使用,你需要兩項資訊:Base URL 和 API 金鑰。
請對所有請求使用以下 Base URL:
https://api.serverlessllmapi.com/v1
驗證透過 Authorization 標頭處理。前往取得 API 金鑰頁面建立帳戶以取得金鑰。你可隨時重新產生此金鑰,舊金鑰將立即失效。妥善保管金鑰,因為它可直接存取你的預付額度。
第一個請求:聊天完成
向 /v1/chat/completions 端點發送標準聊天完成請求。API 接受模型名稱、訊息列表及選用參數。我們的預設模型 ID 為 uncensored,已針對高品質、無限制的回應進行最佳化。
以下是使用 curl 產生回應的基本範例:
curl https://api.serverlessllmapi.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."}]
}'回應遵循標準的 OpenAI JSON 格式。如果請求成功,你將收到包含產生文字的完成物件。這種簡易性允許你只需更改 Base URL 和金鑰,即可將我們的端點置換到現有的 OpenAI SDK 設定中。
Python SDK 整合
使用官方 OpenAI Python SDK 是整合的最快方式。由於我們的 API 為與 OpenAI 相容的 API,你只需覆寫 Base URL 與 API 金鑰即可。這能確保現有程式碼無需修改即可運作。
from openai import OpenAI
client = OpenAI(base_url="https://api.serverlessllmapi.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)此方法可讓你利用熟悉的 Python 函式庫,同時享有我們的無審查模型優勢。上下文視窗支援高達 100,000 token,允許在單一請求中擁有大量的輸入與輸出長度。請確保 messages 陣列包含必要的 system 與 user 提示詞,以有效引導模型。
Node.js SDK 整合
對於 JavaScript 和 TypeScript 開發者,OpenAI Node SDK 提供了直觀的整合路徑。使用我們的 Base URL 和 API 金鑰設定用戶端,即可立即開始發送請求。
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.serverlessllmapi.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);此設定非常適合需要即時 LLM 互動的無伺服器函式或後端服務。按用量計費的定價意味著你只需為使用的部分付費,無需月費。額度不會過期,因此你可以在專案之間暫停使用而不損失餘額。
串流回應 (SSE)
在請求中設定 stream: true以啟用串流輸出。API 將回傳 Server-Sent Events (SSE) 串流,讓你能即時顯示正在產生的 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)在你的用戶端程式碼中處理串流事件以累積最終回應。正確設定後,串流輸出可在 Python 和 Node SDK 中使用。此功能對於需要即時回饋的長篇內容產生特別有用。
速率限制與約束
了解約束條件以確保整合順利。API 對每個 API 金鑰實施 每分鐘 300 次請求 的速率限制。每個請求主體不得超過 8 MB。如果你超過速率限制,將收到 429 狀態碼。
認證錯誤會回傳 401 狀態,表示金鑰無效或已撤銷。如果你的預付額度已耗盡,請求將回傳 402 狀態。模型 ID uncensored 不支援嵌入、圖片產生或微調。請堅持使用基於文字的聊天完成以獲得最佳效能。
API 技術參數
購買額度前,請先確認介面是否符合你的需求——以下是全部真實參數。
| 項目 | 說明 |
|---|---|
| 介面格式 | 相容 OpenAI:任何 OpenAI SDK 只需更換 base URL 和金鑰 |
| 模型 ID | uncensored |
| 驗證 | Authorization: Bearer YOUR_KEY |
| Base URL | https://api.serverlessllmapi.com/v1 |
| 端點 | POST /v1/chat/completions · GET /v1/models |
| 函式呼叫 | 支援 tools、tool_choice;回覆包含 tool_calls(串流同樣支援),結果以 role: tool 訊息回傳 |
| 串流輸出 | 支援 SSE,最後一段包含 token 用量 |
| 上下文視窗 | 100,000 tokens(輸入與輸出合計) |
| 取樣參數 | temperature、top_p、stop、seed、presence_penalty、frequency_penalty |
| 最大輸出 | 不另設輸出上限;提示+回覆共 100,000 個 token 視窗內,max_tokens 可選 |
| JSON 模式 | response_format: {"type": "json_object"} |
| 並行請求 | 每把金鑰同時最多 8 個請求 |
| 回應標頭 | X-Request-Id、X-Balance-USD、X-RateLimit-Limit-Requests、X-RateLimit-Limit-Concurrency |
| 請求大小 | 每次請求不超過 8 MB |
| 速率限制 | 每把金鑰每分鐘 300 次請求 |
| 額度效期 | 付費額度永不過期,無訂閱 |
| 計費 | 預付額度,按實際 token 用量扣費;錯誤和拒絕不收費 |
| 免費試用 | $0.50,有效期 7 天,不需信用卡 · 試用金鑰:2 個並行請求,每分鐘 60 次;首次儲值後恢復完整限額(8 和 300) |
| 價格 | 輸入 $0.25 / 百萬 tokens · 輸出 $1.00 / 百萬 tokens |
| 贈送額度 | 滿 $50 送 5%,滿 $100 送 10% |
| 儲值 | USDT(TRC20)或 USDC(Base),$10–$500 任意整數金額 |
| 內容政策 | 允許成人內容;涉及未成年人的性內容一律拒絕 |
| 金鑰 | 每個帳戶一把有效金鑰;產生新金鑰後舊金鑰失效 |
| 登入 | 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 | 模型忙碌——幾秒後重試 |
問答
閱讀文件上下文視窗大小為何?
上下文視窗支援最多 100,000 token,涵蓋輸入提示詞與輸出完成的總和。這允許在單一請求中進行大量對話或大型文件處理。
如何在 Python 中處理串流輸出?
在 API 呼叫中將 <code>stream</code> 參數設為 <code>true</code>。SDK 將回傳一個可疊代物件,隨著文字產生而逐塊回傳,允許即時顯示回應。
我可以將此 API 與其他 OpenAI SDK 搭配使用嗎?
是的,此 API 為與 OpenAI 相容的 API。任何支援 OpenAI API 格式的用戶端均可透過更新 Base URL 與 API 金鑰進行連線。這包括 Node.js、Go 及其他語言的函式庫。
只差一張表單,即可取得金鑰
建立帳戶、複製金鑰、更改 Base URL。這就是整個設定。