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 模型。此端点处理所有标准的聊天补全。您在请求体中定义模型、消息和参数。

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 模型。在您的补全请求中使用此确切的 ID。API 仅提供此单一模型。没有路由或模型选择逻辑。您直接与我们的专用无审查 LLM 实例交互。

流式传输与使用数据

通过将 stream: trueAPI 通过服务器发送事件（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)

最后一个数据块包含完整的令牌使用统计信息。您仅为生成的输出令牌付费。错误和拒绝不会产生费用。这种结构允许在您的应用程序中实时渲染响应。

参数：温度、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 错误。请相应地规划您的批处理策略。积分永不过期，因此您可以随时间累积使用量而无需压力。