Dolphin AI API 快速入門

基礎 URL 與驗證

開始在客戶端設定中設定基礎 URL 和 API 金鑰。所有請求均透過 Authorization 標頭使用您的專屬金鑰。我們的服務作為獨立供應商，提供對 openrouter dolphin AI model 變體，這意味著您不需要 OpenRouter 帳戶即可使用此端點。只需從儀表板獲取您的金鑰，然後將其放入環境變數中即可。

• 基礎 URL： https://api.openrouterdolphinai.com/v1
• 標頭： Authorization: Bearer YOUR_API_KEY

此設定適用於任何標準 OpenAI SDK，因為我們模擬了他們確切的端點結構。您將僅與聊天完成端點互動，保持整合簡單並專注於文字生成。

首次請求

使用簡單的 POST method。模型 ID 始終是 uncensored, 確保您獲得專門針對無限制對話調整的特定 uncensored 變體。由於我們直接託管此單一模型，因此無需指定複雜的路由參數。

使用以下 curl 指令立即測試您的連線：

Copycurl https://api.openrouterdolphinai.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Fix the syntax error in this python function"}]
  }'

如果您收到包含內容的 JSON 回應，表示您的金鑰有效且信用額度扣減正確。401 等錯誤表示金鑰無效，而 402 表示您需要透過加密貨幣充值。這種直接方法可避免多模型路由器帶來的變異性。

Python SDK 集成

透過將官方 OpenAI Python 函式庫指向我們的 Base URL 來快速整合。這使您可以使用熟悉的方法，例如 chat.completions.create() 無需重寫整個邏輯。該程式庫會自動處理序列化，讓您可以專注於提示詞設計，而非 HTTP 細節。

使用您的基礎 URL 和金鑰配置客戶端：

Copyfrom openai import OpenAI

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

請記住，我們的上下文視窗為 100,000 個 token，因此您可以傳遞大量的對話歷史。SDK 將高效處理 tokenization 和傳輸，確保您的提示無額外開銷或格式錯誤地到達模型。

Node SDK 用法

Node 開發人員可以使用 openai npm 套件。就像 Python 版本一樣，您必須覆寫預設的 base URL 以指向我們的專屬伺服器。這確保您的請求直接發送至無審查模型，不會受到第三方速率限制或路由延遲的影響。

使用正確的端點初始化客戶端：

Copyimport OpenAI from "openai";

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

此模式同時適用於同步呼叫與 async/await 模式。您可以在同一個函式呼叫中直接串流回應或要求 JSON 模式，為不同的應用程式架構提供彈性，而無需更改核心驗證設定。

串流回應

透過設定 stream: true 在您的請求參數中。API 回傳伺服器發送事件（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)

每個區塊的最後一部分包含 token 用量數據，因此您可以準確追蹤成本。串流傳輸非常適合聊天介面，即時回饋能提升使用者參與度。如果使用者發送新訊息，您可以隨時停止串流，從而節省部分回應的費用。

限制、錯誤與上下文

了解技術邊界以避免應用程式中出現意外的中斷。我們的 API 對每次請求實施 100,000 個 token 的上下文視窗，結合提示詞與補全。如果您超過 16,000 個 token 的輸出限制，生成將停止，因此請設定 max_tokens 相應地控制成本。

常見的 HTTP 狀態碼包含 401（金鑰無效）、402（信用不足）與 429（速率限制）。每支金鑰的限額為每分鐘 300 次請求。這些限制確保所有使用者的公平使用。請使用 429 在您的客戶端程式碼中實作指數退避機制，以確保在流量高峰期平穩運行。