Dolphin ai 聊天 API 快速入门指南

SDK 安装 & 配置

首先为您的语言安装官方客户端库。我们的 API 使用标准 OpenAI 包结构，所以你很可能已经有了它。将基础 URL 配置指向我们的端点并提供你的 API 密钥。

使用环境变量方法来保持凭据安全。基地址为 HTTPS://api.dolphinaichat.com/v1。通过更改 base_url 和 API 密钥，这适用于任何 OpenAI 兼容客户端。

Copyfrom openai import OpenAI

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

Copyimport OpenAI from "openai";

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

发起首次 POST 请求

发送简单的聊天完成请求以测试连接。使用模型 ID "uncensored" 获取针对无限制响应优化的开放权重模型。

Copycurl https://api.dolphinaichat.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Summit the daily server load statistics for the last week"}]
  }'

处理流式响应（SSE）

启用流式传输以实时接收令牌。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

该模型支持 100,000 token 的上下文窗口，用于提示词和补全的总和。每次请求的最大输出为 16,000 token。如果未设置 max_tokens，默认值为 2,048。输入 token 的价格为每 1M 个 $0.15，输出 token 的价格为每 1M 个 $0.50。

错误代码 & 速率限制

优雅地处理标准 HTTP 错误。401 表示密钥无效。402 表示您没有余额。429 表示速率限制。限制为每个密钥每分钟 300 次请求和 8 个并发请求。请求体最大为 8 MB。

JSON 模式与函数调用设置

使用 response_format: {"type": "json_object"} 用于结构化输出。通过 tools 和 tool_choice。诸如 temperature 和 top_p 的参数完全受支持。