OpenRouter dolphin API 快速入門指南

基礎 URL 與驗證

所有請求的基礎 URL 為 https://api.openrouterdolphin.com/v1. 通過在 Authorization

Copycurl https://api.openrouterdolphin.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "List the top 10 libraries for Python web scraping."}]
  }'

驗證很嚴格。我們不支援每個帳戶多個金鑰。生成新金鑰會立即使舊金鑰失效。這確保了對您預付信用使用的清晰追蹤。

端點：POST /v1/chat/completions

使用 uncensored model。此端點處理所有標準的聊天補全。您在請求主體中定義模型、訊息和參數。

Copyfrom openai import OpenAI

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

API 回傳包含生成文字的標準 JSON 物件。它不支援嵌入向量、影像或音訊。請專注於文字生成工作流程。該模型在提示時不會過濾合法的成人內容或有爭議的主題。

端點：GET /v1/models

透過簡單的 GET 請求檢索可用模型。此端點確認您必須使用的模型 ID。

Copyimport OpenAI from "openai";

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

回應列出 uncensored model。在您的補全請求中使用此確切的 ID。API 僅提供此單一模型。無路由或模型選擇邏輯。您直接與我們專用的 uncensored LLM 執行個體互動。

串流與使用資料

在請求主體中將 stream: true。API 透過伺服器發送事件（SSE）回傳資料片段。每個片段包含部分回應文字。

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 使用統計數據。您僅為生成的輸出 token 付費。錯誤和拒絕不會產生費用。這種結構允許在您的應用程式中即時渲染回應。

參數：溫度、Top P 與工具

使用標準參數控制生成行為。設定 temperature 用於隨機性，以及 top_p 用於核採樣。透過提供 tools 陣列。

使用 response_format 與 {"type": "json_object"} 用於嚴格的 JSON 輸出。您也可以設定 seed 用於確保結果可重現。該 API 支援 presence_penalty 和 frequency_penalty 用於微調詞彙使用。這些參數的行為與標準 OpenAI 客戶端完全相同。

速率限制與請求大小

每個 API 金鑰允許每分鐘 300 次請求。您隨時最多可有 8 個並行請求。最大請求主體大小為 8 MB。上下文視窗支援 100,000 個 token 的輸入與輸出總和。

每次請求的最大輸出為 16,000 個 token。若未設定 max_tokens, 預設值為 2,048 個 token。超出這些限制會返回 429 錯誤。請相應地規劃您的批次處理策略。信用額度永不過期，因此您可以隨時間累積使用量而無需壓力。