认证与基础 URL 设置
您的 API 密钥对所有请求进行身份验证,我们的服务器。只需使用 Google 或电子邮件地址注册,并从您的仪表板复制密钥。将其粘贴到您的环境变量中,作为 DEEPSEEK_API_KEY 并将您的客户端指向 https://api.keyapideepseek.com/v1. 此基础 URL 可与任何标准 OpenAI 兼容库配合使用。
curl https://api.keyapideepseek.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [{"role": "user", "content": "Check the system health and confirm uptime status"}]
}'您可以通过列出可用模型来验证您的设置。响应确认您的密钥有效且处于活动状态。此步骤确保您的集成指向正确的无过滤端点,然后再发送提示词。
聊天完成端点
The POST /v1/chat/completions 端点接受您的提示并返回模型响应。您发送包含消息、系统指令以及温度等参数的 JSON 主体。模型 ID 始终为 uncensored. 单一模型处理您的所有文本生成需求,无路由复杂性。
from openai import OpenAI
client = OpenAI(base_url="https://api.keyapideepseek.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)Python SDK 自动处理 HTTP 请求。您将密钥和基础 URL 传递给客户端构造函数。其余代码镜像标准 OpenAI 模式。这确保您以后可以切换供应商而无需重写整个应用程序逻辑。
流式响应与 Token 用量
通过将 stream: true 在您的请求中。API 返回服务器发送事件(SSE)块流。每个块包含部分文本和使用统计信息。最后一个块包含请求的总令牌数。
stream = 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 使用情况,以准确跟踪预付费信用的消耗。
JSON 模式与函数调用
通过设置强制使用结构化输出 response_format 到 {"type": "json_object"}模型返回有效的 JSON 而非自由文本。这对于 API 集成或数据提取任务非常理想。你还可以在提示中定义函数定义以进行工具使用。
该模型支持 tool_choice 参数。您可以强制特定函数或让模型自行决定。这种灵活性允许您构建复杂的代理。确保您的函数模式具有严格类型,以避免客户端代码中的解析错误。
速率限制与并发
每个 API 密钥每分钟限 300 次请求。您最多可同时发起 8 个并发请求。最大请求体大小为 8 MB。这些限制可防止滥用并确保所有用户的稳定性能。超出限制将返回 429 错误。
在客户端代码中实现指数退避。在短暂延迟后重试失败的请求。这可以优雅地处理临时网络问题。您的预付费信用仅在成功完成时收费,而不是针对速率限制的重试。
错误处理和拒绝
401 错误表示您的密钥无效或已过期。402 错误表示预付费余额不足。429 错误表示您已达到速率限制。该模型拒绝包含涉及未成年人性内容的请求。其他合法的成人内容允许使用。
检查错误响应正文以获取详细消息。记录这些错误以调试集成问题。你的信用额度不会因失败的请求而消耗。这种透明的计费模式帮助你准确预测成本,没有隐藏费用。
Node.js
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.keyapideepseek.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);