一. 接口提交示例

接口地址: https://api.deepseek.com/chat/completions

模型名称: deepseek-chat

SK (没有可不填): sk-xxxxxxxxxxx

二. 接口标准示例

1. 请求参数

1.1 请求URL

示例: "POST https://api.deepseek.com/chat/completions"

1.2 请求头

字段名	类型	必填	说明
Content-Type	String	是	请求内容类型，必须为application/json
Authorization	String	否	授权Token，格式为Bearer <token>

1.3 请求体

请求体为一个JSON对象，包含以下字段：

字段名	类型	必填	描述
messages	array	是	消息数组，包含聊天历史
model	string	是	使用的模型名称

messages 对象

字段名	类型	必填	描述
content	string	是	消息内容
role	string	是	消息角色

1.4 请求示例 (红色部分为所需提交的部分):

import requests
import json

url = "https://api.deepseek.com/chat/completions"

payload = json.dumps({
    "messages": [
        {
            "content": "You are a helpful assistant",
            "role": "system"
        },
        {
            "content": "Hi",
            "role": "user"
        }
    ],
    "model": "deepseek-chat",
})
headers = {
    'Content-Type': 'application/json',
    'Accept': 'application/json',
    'Authorization': 'Bearer sk-xxxxxxxxxxx' # 若无sk, 则 Authorization 字段可以不要
}

response = requests.post(url, headers=headers, data=payload)

print(response.text)
        

2. 响应参数

2.1 响应头

参数名	类型	说明
Content-Type	String	响应内容类型，application/json

2.2 响应体

响应体为一个JSON对象，包含以下字段：

字段名	类型	必需	描述
id	string	否	请求的唯一标识
object	string	否	响应对象类型
created	integer	否	响应创建的时间戳
model	string	否	使用的模型名称
choices	array	是	生成的回复数组

choices 对象

字段名	类型	必需	描述
index	integer	否	选项索引
message	object	是	包含生成的消息内容
finish_reason	string	否	消息生成的结束原因

message 对象

字段名	类型	必需	描述
role	string	是	消息角色
content	string	是	消息内容

2.3 返回示例:

重点字段路径: ["choices"][0]["message"]["content"] 或 ["choices"][0]["message"]["text"]

{
    "id": "cmpl-04ea926191a14749b7f2c7a48a68abc6",
    "object": "chat.completion",
    "created": 1698999496,
    "model": "deepseek-chat",
    
    "choices": [
        {
            "index": 0,
            "message": {
                "role": "assistant",
                "content": " 你好，如果你有其他问题，请随时提问！"
            },
            "finish_reason": "stop"
        }
    ]
}