Dolphin nsfw API 文档

基础 URL 和认证

使用标准 OpenAI 兼容基地址进行连接。将现有的 API 密钥替换为从仪表板生成的密钥。我们支持接受基地址覆盖的任何客户端库。

• 基础 URL： https://api.dolphinnsfw.com/v1
• 认证：请求头中的 Bearer 令牌 Authorization 。

认证是即时的。您的密钥在生成后立即生效。不需要电话号码。通过 Google 或电子邮件注册。仪表板只显示一次您的密钥。错误是免费的。拒绝不收费。这确保您只为实际令牌付费。

首次请求

发送到聊天端点的完成请求。模型 ID 是 uncensored它处理成人主题而无需拒绝。使用标准的 JSON 结构。请求体包括 messages 和参数。

以下是测试连接的基本 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"}]
  }'

这适用于任何简单的文本生成任务。您可以调整temperature和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)

该库自动处理重试。它自动管理标头。您将获得结构化数据。这种方法既适用于本地脚本，也适用于 Web 应用。

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。错误不消耗积分，保护您的预算。预付积分永不过期。可使用试用积分先进行测试。