DeepSeek API

DeepSeek 提供 OpenAI 兼容 API。官方 API Key 通过 Bearer Token 传递，Chat Completions 使用 /chat/completions 路径。

官方文档：

鉴权

Header：Authorization: Bearer $DEEPSEEK_API_KEY
Header：Content-Type: application/json

Base URL

Base URL	说明
`https://api.deepseek.com`	官方基础地址。
`https://api.deepseek.com/v1`	也支持用于 OpenAI SDK 兼容；`v1` 与模型版本无关。

Chat Completions

方法：POST
路径：/chat/completions
完整地址：https://api.deepseek.com/chat/completions

请求参数

参数	类型	必填	说明
`model`	string	是	模型名称，例如 `deepseek-v4-flash`、`deepseek-v4-pro`、`deepseek-chat` 或 `deepseek-reasoner`，以官方当前可用模型为准。
`messages`	array	是	OpenAI 兼容消息数组。
`messages[].role`	string	是	`system`、`user`、`assistant` 或 `tool`。
`messages[].content`	string \| array	是	消息内容。
`temperature`	number	否	采样温度。
`top_p`	number	否	核采样参数。
`max_tokens`	integer	否	最大输出 Token 数。
`stream`	boolean	否	是否使用流式响应。
`tools`	array	否	函数工具。
`tool_choice`	string \| object	否	工具调用策略。
`response_format`	object	否	JSON 输出格式配置。

请求示例

curl


curl https://api.deepseek.com/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $DEEPSEEK_API_KEY" \
  -d '{
    "model": "deepseek-v4-flash",
    "messages": [
      {
        "role": "system",
        "content": "You are a helpful assistant."
      },
      {
        "role": "user",
        "content": "用一句话介绍GGPU平台。"
      }
    ],
    "temperature": 0.7,
    "max_tokens": 512
  }'

TypeScript


import OpenAI from "openai";
 
const client = new OpenAI({
  apiKey: process.env.DEEPSEEK_API_KEY,
  baseURL: "https://api.deepseek.com",
});
 
const completion = await client.chat.completions.create({
  model: "deepseek-v4-flash",
  messages: [
    { role: "system", content: "You are a helpful assistant." },
    { role: "user", content: "用一句话介绍GGPU平台。" },
  ],
  temperature: 0.7,
  max_tokens: 512,
});
 
console.log(completion.choices[0]?.message?.content);

Python


import os
from openai import OpenAI
 
client = OpenAI(
    api_key=os.environ["DEEPSEEK_API_KEY"],
    base_url="https://api.deepseek.com",
)
 
completion = client.chat.completions.create(
    model="deepseek-v4-flash",
    messages=[
        {"role": "system", "content": "You are a helpful assistant."},
        {"role": "user", "content": "用一句话介绍GGPU平台。"},
    ],
    temperature=0.7,
    max_tokens=512,
)
 
print(completion.choices[0].message.content)

流式调用

请求体中设置 stream: true，客户端按 SSE 流读取返回。


curl https://api.deepseek.com/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $DEEPSEEK_API_KEY" \
  -d '{
    "model": "deepseek-v4-flash",
    "messages": [
      {
        "role": "user",
        "content": "请分三点说明 API 网关的作用。"
      }
    ],
    "stream": true
  }'

GGPU网关映射

通过GGPU调用时，请保留同样的 OpenAI 兼容请求体，把 Base URL 替换为GGPU网关地址，并把 DeepSeek API Key 替换为GGPU访问凭证明文。


curl http://127.0.0.1:18080/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <access-credential-secret>" \
  -d '{
    "model": "deepseek-v4-flash",
    "messages": [
      {
        "role": "user",
        "content": "用一句话介绍GGPU平台。"
      }
    ]
  }'