- NSFW Video API
- 快速上手:將無審查文字整合至您的影片工作流程
快速上手:將無審查文字整合至您的影片工作流程
透過此快速上手指南,將我們的無審查文字 API 整合至您的 NSFW 影片管線。您將學會如何使用標準 OpenAI 相容客戶端進行身份驗證、生成腳本以及串流輸出回應。
基礎 URL 與身份驗證
我們的 API 託管於 https://api.nsfwvideo.top/v1。要進行身份驗證,您需要從帳戶儀表板獲取 API 金鑰。您可以透過 Google 或電子郵件註冊,立即獲得金鑰。將此金鑰作為 Bearer token 傳遞至 Authorization 標頭。此設定適用於任何 OpenAI 相容 SDK,只需配置基礎 URL 和 API 金鑰即可。確保您的客戶端將請求發送至我們的特定端點,以存取無審查模型。
生成影片腳本
向 /v1/chat/completions 發送 POST 請求,並指定模型 ID 為 uncensored。此模型經過調校,可在合法成人用途下無內容拒絕地回答,非常適合用於 NSFW 影片腳本。您可以要求詳細的場景描述或對話。API 返回的文字可直接輸入您的影片生成管線,以獲得一致的輸出。
curl https://api.nsfwvideo.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."}]
}'
使用 JSON 模式進行提示詞工程
對於結構化資料,請使用 response_format 參數並設定為 {"type": "json_object"}。這可確保模型返回有效的 JSON,對於在自動化工作流程中解析元資料或結構化提示詞至關重要。您可以在系統提示詞中定義 schema,以強制執行特定鍵,如 scene_description 或 camera_angles。這能減少後製處理的負擔,並保持管線的整潔。
from openai import OpenAI
client = OpenAI(base_url="https://api.nsfwvideo.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)
串流輸出回應
將 stream 設為 true 以啟用串流輸出。API 透過 Server-Sent Events (SSE) 回傳資料片段。這讓你能即時顯示進度或處理 token。每個資料片段包含部分文字,最後一個資料片段則包含 token 使用統計。串流輸出對於長腳本非常有效率,讓你的應用程式能在內容產生時立即做出反應,無需等待完整回應。
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.nsfwvideo.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);
處理上下文視窗
上下文視窗為 100,000 個 token,涵蓋提示詞與補全內容。每次請求的最大輸出為 32,000 個 token,若未設定 max_tokens,則為 2,048 個 token。請根據此限制規劃輸入長度,以避免截斷。對於長對話,請透過修剪較舊的訊息來管理歷史記錄。這可確保模型有足夠的空間處理相關上下文,維持影片腳本生成的一致性。
速率限制與 token
您的限制為每分鐘 300 次請求,每支金鑰最多 8 個並行請求。請求主體不得超過 8 MB。401(金鑰無效)或 402(無額度)等錯誤不會消耗您的預付額度。速率限制 (429) 也不會消耗額度,讓您可無罰款地重試。僅在成功使用 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 技術參數
購買額度前,請先確認介面是否符合你的需求——以下是全部真實參數。
| 項目 | 說明 |
|---|---|
| 介面格式 | 相容 OpenAI:任何 OpenAI SDK 只需更換 base URL 和金鑰 |
| 模型 ID | uncensored |
| 驗證 | Authorization: Bearer YOUR_KEY |
| 端點 | POST /v1/chat/completions · GET /v1/models |
| Base URL | https://api.nsfwvideo.top/v1 |
| 最大輸出 | 不另設輸出上限;提示+回覆共 100,000 個 token 視窗內,max_tokens 可選 |
| 取樣參數 | temperature、top_p、stop、seed、presence_penalty、frequency_penalty |
| 上下文視窗 | 100,000 tokens(輸入與輸出合計) |
| JSON 模式 | response_format: {"type": "json_object"} |
| 串流輸出 | 支援 SSE,最後一段包含 token 用量 |
| 函式呼叫 | 支援 tools、tool_choice;回覆包含 tool_calls(串流同樣支援),結果以 role: tool 訊息回傳 |
| 速率限制 | 每把金鑰每分鐘 300 次請求 |
| 回應標頭 | X-Request-Id、X-Balance-USD、X-RateLimit-Limit-Requests、X-RateLimit-Limit-Concurrency |
| 並行請求 | 每把金鑰同時最多 8 個請求 |
| 請求大小 | 每次請求不超過 8 MB |
| 贈送額度 | 滿 $50 送 5%,滿 $100 送 10% |
| 計費 | 預付額度,按實際 token 用量扣費;錯誤和拒絕不收費 |
| 價格 | 輸入 $0.25 / 百萬 tokens · 輸出 $1.00 / 百萬 tokens |
| 額度效期 | 付費額度永不過期,無訂閱 |
| 免費試用 | $0.50,有效期 7 天,不需信用卡 · 試用金鑰:2 個並行請求,每分鐘 60 次;首次儲值後恢復完整限額(8 和 300) |
| 儲值 | 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 | 模型忙碌——幾秒後重試 |
問答
如果額度用完會發生什麼事?
您的 API 金鑰仍會保持作用中,但請求將返回 402 錯誤,表示資金不足。您可以隨時透過加密貨幣儲值以恢復使用。錯誤與拒絕請求均免費,因此您不會為失敗的嘗試付費。
API 支援函式呼叫嗎?
是的,API 支援透過 <code>tools</code> 和 <code>tool_choice</code> 參數進行函式呼叫。您可以在請求中定義自訂函式,讓模型返回結構化資料。這有助於將 API 整合至影片製作工作流程的其他部分。
有免費方案嗎?
沒有免費方案。不過,每個新帳戶都會獲得 $0.50 的免費試用額度,有效期為 7 天。你可以從 $10 起使用加密貨幣儲值。額度永不過期,可用於任何請求類型。
只差一張表單,即可取得金鑰
建立帳戶、複製金鑰、更改基礎 URL。設定即完成。