Dolphin 模型 API 快速入门

基础 URL 和认证

Dolphin 模型 API 是一项 OpenAI 兼容服务。将您的基础 URL 设置为 https://api.dolphinmodelos.com/v1 并在 Authorization 头部，使用模型 ID uncensored 用于推理。这确保了与标准 SDK 的兼容性，无需自定义路由逻辑。

Copycurl https://api.dolphinmodelos.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "List endpoints for wallet connection via crypto gateway"}]
  }'

发送补全请求

发送简单的文本提示以生成回复。API 接受标准参数，如 temperature 和 top_p. 您获得纯文本输出，没有多余的外壳。这种直接方法消除了对特定模型解析逻辑的需求。

Copyfrom openai import OpenAI

client = OpenAI(base_url="https://api.dolphinmodelos.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 的流式响应

使用服务器发送事件启用实时令牌生成。最后一个块包含完整的令牌用量统计信息，以确保计费准确。流式传输可降低长输出的感知延迟。此方法非常适合需要即时反馈的交互式应用程序。

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)

函数调用与工具

定义工具以让模型执行特定操作。使用 tool_choice 用于强制执行函数使用。API 支持标准的工具定义并返回结构化参数。这使复杂工作流无需外部解析脚本即可实现。通过标准的 OpenAI 格式配置工具以实现无缝集成。

用于结构化输出的 JSON 模式

使用 response_format: {"type": "json_object"}. 这确保了下游处理的数据结构一致性。非常适合 API 响应或数据库插入。模型遵循架构，不添加对话式填充文本。

错误处理和限制

上下文窗口总计 100,000 个 token。处理如 401（无效密钥）或 429（速率限制）等错误。API 限制每分钟 300 次请求。使用这些代码高效管理重试。错误和拒绝不消耗额度，在测试阶段保护您的余额。

Node.js

Copyimport OpenAI from "openai";

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