API 接入文档

欢迎使用 DeepSeek API 极速中转引擎。我们的 API 接口设计完全兼容 OpenAI 的规范，这意味着您可以直接使用官方的 SDK（如 openai-python、openai-node）或兼容的第三方开源工具（如 NextChat、LobeChat 等）无缝切换至本平台。

1. 接口 Base URL

在所有发起请求的客户端中，您需要将官方的接口域名替换为我们的节点地址：

注意：URL 末尾包含 /v1，请勿遗漏。若使用的第三方工具默认会自动拼接 /v1，则只需填写 https://api.13933.cn。

2. 认证方式 (Authentication)

所有的 API 请求必须在 HTTP Header 中包含您的 API Key，使用 Bearer Token 认证机制。

Authorization: Bearer sk-您的专属APIKey

3. 核心接口：对话生成 (Chat Completions)

给定一个对话历史，模型将返回一条生成的回复。这是最常用的接口，支持流式输出 (Stream)。

请求参数 (Request Body)

可用模型 (Models)

• deepseek-chat DeepSeek V3 核心对话模型，适用于绝大多数文本生成、问答、翻译等任务。
• deepseek-coder 专为编程、代码生成、Debug 优化的代码模型。
• 注意：平台还支持其他第三方模型（如 GPT-4、Claude 等），具体请以用户后台“可用模型”列表为准。

4. 接入代码示例

Python 示例 (使用官方 SDK)

首先安装依赖：pip install openai

from openai import OpenAI

client = OpenAI(
    api_key="sk-您的专属APIKey",
    base_url="https://api.13933.cn/v1"
)

# 开启 stream=True 进行流式输出
response = client.chat.completions.create(
    model="deepseek-chat",
    messages=[
        {"role": "system", "content": "You are a helpful assistant."},
        {"role": "user", "content": "请用Python写一个冒泡排序。"}
    ],
    stream=True
)

for chunk in response:
    if chunk.choices[0].delta.content is not None:
        print(chunk.choices[0].delta.content, end="", flush=True)

Node.js 示例

首先安装依赖：npm install openai

import OpenAI from 'openai';

const openai = new OpenAI({
  apiKey: 'sk-您的专属APIKey',
  baseURL: 'https://api.13933.cn/v1',
});

async function main() {
  const stream = await openai.chat.completions.create({
    model: 'deepseek-chat',
    messages: [{ role: 'user', content: 'Say this is a test' }],
    stream: true,
  });

  for await (const chunk of stream) {
    process.stdout.write(chunk.choices[0]?.delta?.content || '');
  }
}

main();

cURL 示例

curl https://api.13933.cn/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-您的专属APIKey" \
  -d '{
    "model": "deepseek-chat",
    "messages": [
      {
        "role": "system",
        "content": "You are a helpful assistant."
      },
      {
        "role": "user",
        "content": "Hello!"
      }
    ]
  }'

5. 错误码说明 (Error Codes)

当请求失败时，接口会返回标准的 HTTP 状态码，并在 JSON body 中包含错误详情：

6. 常见问题 (FAQ)