API 概述

薄荷云 Deepseek API 提供了基于 Deepseek 模型的对话能力，支持自然语言处理和生成。

认证方式

所有API请求都需要在请求头中包含 API 密钥：

X-API-Key: your_api_key_here

对话接口

请求参数

参数名	类型	是否必需	描述
messages	array	是	对话消息数组

请求示例

{
    "messages": [
        {
            "role": "user",
            "content": "你好，请介绍一下自己"
        }
    ]
}

响应示例

{
    "status": "success",
    "data": {
        "choices": [
            {
                "message": {
                    "role": "assistant",
                    "content": "你好！我是一个AI助手..."
                }
            }
        ],
        "usage": {
            "total_tokens": 100
        }
    }
}

错误处理

当API调用出现错误时，会返回对应的错误信息：

{
    "status": "error",
    "message": "错误描述信息"
}

HTTP状态码	说明
400	请求参数错误
401	API密钥无效
429	请求过于频繁
500	服务器内部错误

代码示例

Python

import requests

api_key = 'your_api_key_here'
url = 'http://ai.com/api/chat.php'

headers = {
    'X-API-Key': api_key,
    'Content-Type': 'application/json'
}

data = {
    'messages': [
        {
            'role': 'user',
            'content': '你好，请介绍一下自己'
        }
    ]
}

response = requests.post(url, json=data, headers=headers)
print(response.json())

JavaScript

const apiKey = 'your_api_key_here';
const url = 'http://ai.com/api/chat.php';

fetch(url, {
    method: 'POST',
    headers: {
        'X-API-Key': apiKey,
        'Content-Type': 'application/json'
    },
    body: JSON.stringify({
        messages: [
            {
                role: 'user',
                content: '你好，请介绍一下自己'
            }
        ]
    })
})
.then(response => response.json())
.then(data => console.log(data));