Dolphin AI API 快速入門指南

基礎 URL 與驗證

驗證需要一個在 Authorization 標頭。

每次請求必須指向基礎 URL https://api.dolphinaisincensura.com/v1 並將金鑰包含為 Bearer YOUR_API_KEY.

此設定適用於任何 OpenAI 相容的 SDK，只需更新 base_url 設定。

錯誤如 401 表示無效或缺失的金鑰，而 402 表示預付積分不足。

Copycurl https://api.dolphinaisincensura.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "list the python imports for requests and json"}]
  }'

發送聊天完成請求

向以下網址發送 POST 請求 /v1/chat/completions 具備 model field set to uncensored.

包含一個 messages 包含您的提示歷史記錄的陣列，以維持對話上下文。

API 直接在 content field of the first choice.

此單一模型方法消除了代理費用，並確保可預測的定價為每 1M 輸入 token $0.15。

Copyfrom openai import OpenAI

client = OpenAI(base_url="https://api.dolphinaisincensura.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)

處理串流（SSE）

在請求主體中將 stream 以 true 在您的請求主體中。

伺服器透過伺服器發送事件（SSE）遞增式地傳送 token。

解析每個 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)

函式呼叫與 JSON 模式

使用 tools 用於定義結構化資料擷取的函數結構描述。

設定 response_format 以 {"type": "json_object"} 以強制執行嚴格的 JSON 輸出以進行可靠解析。

指定 temperature 和 top_p 控制創意與結果中的確定性。

這些功能讓您能夠建構與外部 API 或資料庫互動的自主代理。

Copyimport OpenAI from "openai";

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

了解 Token 限制與上下文

上下文視窗支援提示詞與補全合計 100,000 個 token。

每次請求的最大輸出為 16,000 個 token，若 max_tokens 未設定。

速率限制允許每分鐘 300 次請求，每 API 金鑰 8 個併發請求。

超過 8 MB 主體大小限制或達到併發上限的請求會返回 429 錯誤。

錯誤響應和拒絕不會消耗您的預付信用額。

速率限制與併發

每個 API 金鑰每分鐘限 300 次請求，並限 8 個同時活躍連線。

429 狀態碼表示您已超過這些併發或速率閾值。

您可以產生新的金鑰來取代現有金鑰，但每個帳戶僅允許一個有效金鑰。

您可以透過回應標頭來監控您的使用情況，以保持在 8 MB 請求主體限制之內。