Dolphin nsfw API 文件

基礎 URL 與驗證

使用標準 OpenAI 相容基礎 URL 進行連接。將您現有的 API 金鑰替換為從儀表板生成的金鑰。我們支援任何接受基礎 URL 覆蓋的客戶端庫。

• 基礎 URL： https://api.dolphinnsfw.com/v1
• 驗證：Bearer token 在 Authorization 標頭。

驗證是即時的。您的金鑰在生成後立即生效。不需要手機號碼。使用 Google 或電子郵件註冊。儀表板只會顯示一次您的金鑰。錯誤是免費的。拒絕不收費。這確保您只為實際的 token 付費。

首次請求

向聊天端點發送完成請求。模型 ID 為 uncensored. 它處理成人主題時不會拒絕。使用標準 JSON 結構。請求主體包含訊息與參數。

這是一個測試連線的簡單 curl 命令。它發送一個短提示。回應返回生成的文本。請檢查狀態碼以確認成功。

Copycurl https://api.dolphinnsfw.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Generate a 500 word scene of two dolphins mating at sunset"}]
  }'

這適用於任何簡單的文字生成任務。您可以調整溫度與 top_p。模型回應迅速。無需複雜的設定。

Python SDK 集成

使用官方 OpenAI Python 庫。將 base URL 設為我們的端點。傳遞您的 API 金鑰。程式碼與標準 GPT 用法完全相同。這大幅減少了整合時間。

安裝函式庫。設定客戶端。傳送訊息。回應物件包含產生的文字。您可以從回應中存取 token 使用量。這有助於追蹤成本。

Copyfrom openai import OpenAI

client = OpenAI(base_url="https://api.dolphinnsfw.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 用戶端。指向我們的基礎 URL。使用您的 API 金鑰。語法與官方文件一致。這確保了跨語言的一致性。

建立用戶端實例。定義模型。傳送提示詞。回應包含內容。您可以輕鬆解析 JSON。這非常適合伺服器端渲染。它也適用於無伺服器函式。

Copyimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.dolphinnsfw.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);

SDK 內部處理串流。您也可以手動擷取。這提供了靈活性。選擇符合您架構的方法。

串流與工具使用

啟用串流以獲得即時輸出。將 stream 參數設為 true。API 透過伺服器發送事件（SSE）傳送資料區塊。這可降低感知延遲。使用者可以看到文字即時生成。

支援函式呼叫。在請求中定義工具。模型回傳工具呼叫。您執行它們。然後將結果傳回。這可實現複雜的工作流程。也提供 JSON 模式。設定 response_format 以 {"type": "json_object"}. 這可確保嚴格的輸出格式。

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)

串流支援所有參數。Temperature 和 top_p 適用於每個區塊。這允許更精細的控制。您可以提前終止生成。最後一個區塊包含總 token 用量。

限制、錯誤與上下文

上下文視窗為 100,000 個 token。這包含提示詞和補全內容。最大輸出為 16,000 個 token。請求主體大小為 8 MB。速率限制為每分鐘 300 個請求。併發性為每個金鑰 8 個請求。

優雅地處理錯誤。401 錯誤表示無效。402 錯誤表示沒有信用額度。429 錯誤表示速率限制。這些是標準 HTTP 代碼。您的客戶端應重試或通知用戶。

定價透明。輸入 token 每百萬成本為 $0.15。輸出 token 每百萬成本為 $0.50。錯誤不消耗信用額度。這保護您的預算。預付信用額度永不過期。使用試用信用額度先進行測試。