C++调用DeepSeek API实操指南
作者:暴富20212026.11.17 03:32浏览量:0简介:本文讲解如何用C++直接调用DeepSeek API,包括用libcurl发送请求、用nlohmann/json解析响应的完整代码,修正常见的响应解析错误,并给出可运行的流式输出解析方法。读完可独立完成非流式与流式调用,并掌握401、404、429等故障的排查思路。
一、开始前准备的三项信息
调用DeepSeek API前,需要确定以下三项配置。无论使用C++、Python还是其他语言,这三项都是必需的。
| 信息 | 说明 | 示例 |
|---|---|---|
api_key |
身份凭证,在DeepSeek开放平台控制台创建 | sk-xxxxxxxx |
base_url |
接口基础地址 | https://api.deepseek.com |
model |
模型名称 | deepseek-chat |
实际请求地址为 https://api.deepseek.com/chat/completions。部分SDK或第三方客户端要求 base_url 带 /v1 后缀,以对应文档为准。
二、OpenAI兼容协议的请求结构
DeepSeek API兼容OpenAI协议,请求分为两部分。认证信息放在请求头,业务参数放在JSON请求体。
Authorization: Bearer <你的API_KEY>Content-Type: application/json
API Key不要放在URL参数里,因为URL容易出现在服务器日志和浏览器历史记录中。
常用请求体参数
| 参数 | 类型 | 必选 | 说明 |
|---|---|---|---|
model |
string | 是 | 模型名称,如 deepseek-chat |
messages |
array | 是 | 对话消息列表,每项包含 role 和 content |
temperature |
float | 否 | 随机性,取值通常为0到2,数值越高输出越发散 |
max_tokens |
int | 否 | 本次回复允许生成的最大Token数 |
top_p |
float | 否 | 核采样参数,官方建议与 temperature 二选一调整 |
stream |
bool | 否 | 是否以SSE流式返回,默认为false |
tools |
array | 否 | 工具调用定义 |
response_format |
object | 否 | 指定输出格式,例如JSON输出 |
role 属于 messages 数组中的每个元素,不是请求体的顶层参数。其可选值为 system、user、assistant 和 tool。system 用于设定模型的角色与规则,user 表示用户输入,assistant 表示模型此前的回复。
三、环境准备与项目结构
本文示例依赖三个工具:libcurl负责发送HTTP请求,nlohmann/json负责构造和解析JSON,CMake负责编译配置。
在Debian或Ubuntu上可以直接安装:
sudo apt install libcurl4-openssl-dev nlohmann-json3-dev
在macOS上使用Homebrew安装:
brew install curl nlohmann-json
如果不想安装系统包,可以从nlohmann/json的发布页面下载单头文件 json.hpp,放入项目的 include/nlohmann/ 目录。推荐的项目结构如下:
deepseek_demo/├── CMakeLists.txt├── main.cpp└── include/└── nlohmann/└── json.hpp
CMakeLists.txt 的内容如下,其中 target_include_directories 让编译器能找到 nlohmann/json.hpp:
cmake_minimum_required(VERSION 3.16)project(deepseek_cpp_demo LANGUAGES CXX)set(CMAKE_CXX_STANDARD 17)set(CMAKE_CXX_STANDARD_REQUIRED ON)find_package(CURL REQUIRED)add_executable(deepseek_demo main.cpp)target_include_directories(deepseek_demo PRIVATE ${CMAKE_SOURCE_DIR}/include)target_link_libraries(deepseek_demo PRIVATE CURL::libcurl)
如果通过apt或brew安装了nlohmann/json,则不需要 include 目录,改用 find_package(nlohmann_json 3.11 REQUIRED),并链接 nlohmann_json::nlohmann_json。
不使用CMake时,可以直接编译:
g++ -std=c++17 main.cpp -Iinclude -lcurl -o deepseek_demo
四、非流式调用完整示例
非流式调用会等待模型生成完整回答后一次性返回。下面的代码将网络错误、HTTP状态码错误和JSON结构错误分开处理。
#include <curl/curl.h>#include <nlohmann/json.hpp>#include <cstdlib>#include <iostream>#include <string>using json = nlohmann::json;static size_t WriteToString(char* ptr, size_t size, size_t nmemb, void* userdata) {auto* out = static_cast<std::string*>(userdata);out->append(ptr, size * nmemb);return size * nmemb;}// 成功时返回 true 并写入 answer;失败时把原因写入 errorbool ChatOnce(const std::string& api_key,const std::string& prompt,std::string& answer,std::string& error) {json payload = {{"model", "deepseek-chat"},{"messages", json::array({{{"role", "user"}, {"content", prompt}}})},{"stream", false}};const std::string body = payload.dump();CURL* curl = curl_easy_init();if (!curl) {error = "curl_easy_init failed";return false;}struct curl_slist* headers = nullptr;headers = curl_slist_append(headers, ("Authorization: Bearer " + api_key).c_str());headers = curl_slist_append(headers, "Content-Type: application/json");std::string response_body;curl_easy_setopt(curl, CURLOPT_URL, "https://api.deepseek.com/chat/completions");curl_easy_setopt(curl, CURLOPT_HTTPHEADER, headers);curl_easy_setopt(curl, CURLOPT_POSTFIELDS, body.c_str());curl_easy_setopt(curl, CURLOPT_WRITEFUNCTION, WriteToString);curl_easy_setopt(curl, CURLOPT_WRITEDATA, &response_body);curl_easy_setopt(curl, CURLOPT_CONNECTTIMEOUT, 10L);curl_easy_setopt(curl, CURLOPT_TIMEOUT, 60L);CURLcode res = curl_easy_perform(curl);long status = 0;if (res == CURLE_OK) {curl_easy_getinfo(curl, CURLINFO_RESPONSE_CODE, &status);}curl_slist_free_all(headers);curl_easy_cleanup(curl);if (res != CURLE_OK) {error = std::string("网络错误: ") + curl_easy_strerror(res);return false;}if (status != 200) {error = "HTTP " + std::to_string(status) + ": " + response_body;return false;}try {json resp = json::parse(response_body);// choices 是数组,必须用 [0] 取第一个元素if (!resp.contains("choices") || !resp["choices"].is_array() || resp["choices"].empty()) {error = "响应中没有 choices: " + response_body;return false;}const json& choice = resp["choices"][0];if (!choice.contains("message") || !choice["message"].contains("content")) {error = "choices[0] 中没有 message.content: " + response_body;return false;}answer = choice["message"]["content"].get<std::string>();return true;} catch (const json::exception& e) {error = std::string("JSON 解析失败: ") + e.what();return false;}}int main() {const char* env_key = std::getenv("DEEPSEEK_API_KEY");if (!env_key || *env_key == '\0') {std::cerr << "请先设置环境变量 DEEPSEEK_API_KEY" << std::endl;return 1;}// 整个程序只需调用一次,且要在创建任何线程之前调用curl_global_init(CURL_GLOBAL_DEFAULT);std::string answer;std::string error;if (ChatOnce(env_key, "用一句话介绍 C++", answer, error)) {std::cout << answer << std::endl;} else {std::cerr << "调用失败: " << error << std::endl;}curl_global_cleanup();return 0;}
编译运行前,先在终端设置环境变量:
export DEEPSEEK_API_KEY="sk-xxxxxxxx"./deepseek_demo
这段代码的要点有三个。第一,choices 是数组,因此取值写作 resp["choices"][0]["message"]["content"]。第二,取值前先用 contains 检查字段是否存在,避免访问不存在的键导致程序异常。第三,每个线程需要使用独立的 CURL 句柄,而 curl_global_init 只需全局调用一次。
五、流式输出的SSE解析
将请求体中的 stream 设为 true 后,服务端以Server-Sent Events(SSE)格式逐段返回数据。每条有效数据以 data: 开头,内容是一个JSON对象,回答的增量文本位于 choices[0].delta.content。全部内容结束后,服务端会发送一行 data: [DONE]。
流式解析有一个容易忽略的问题:网络分包不会按行对齐,一行 JSON 可能被拆成两次回调。因此需要维护一个缓冲区,只在遇到换行符时处理完整的一行。
```cpp
struct StreamState {
std::string raw; // 全部原始响应,用于排查错误
std::string buffer; // 尚未凑成完整行的数据
bool done = false; // 是否收到 data: [DONE]
std::string error; // 解析出的错误信息
};
static void HandleLine(StreamState& st, std::string line) {
if (!line.empty() && line.back() == ‘\r’) {
line.pop_back(); // 兼容 \r\n 换行
}
const std::string prefix = "data:";if (line.compare(0, prefix.size(), prefix) != 0) {return; // 跳过空行(事件分隔符)和其他字段}std::string payload = line.substr(prefix.size());if (!payload.empty() && payload[0] == ' ') {payload.erase(0, 1);}if (payload == "[DONE]") {st.done = true;return;}try {json chunk = json::parse(payload);if (chunk.contains("error")) {st.error = chunk["error"].dump();return;}if (!chunk.contains("choices") || !chunk["choices"].is_array() || chunk["choices"].empty()) {return;}const json& choice = chunk["choices"][0];if (choice.contains("delta") && choice["delta"].contains("content")) {const json& piece = choice["delta"]["content"];if (piece.is_string()) {std::cout << piece.get<std::string>() << std::flush;}}} catch (const json::exception& e) {st.error = std::string("解析 SSE 数据失败: ") + e.what() + " 原始数据: " + payload;}
}
static size_t StreamWriteCallback(char ptr, size_t size, size_t nmemb, void userdata) {
auto st = static_cast<StreamState>(userdata);
const size_t total = size * nmemb;
st->raw.append(ptr, total);
st->buffer.append(ptr, total);
size_t pos = 0;while (!st->done && (pos = st->buffer.find('\n')) != std::string::npos) {std::string line = st->buffer.substr(0, pos);st->buffer.erase(0, pos + 1);HandleLine(*st, line);}return total;
}
bool ChatStream(const std::string& api_key, const std::string& prompt, std::string& error) {
json payload = {
{“model”, “deepseek-chat”},
{“messages”, json::array({
{{“role”, “user”}, {“content”, prompt}}
})},
{“stream”, true}
};
const std::string body = payload.dump();
CURL* curl = curl_easy_init();if (!curl) {error = "curl_easy_init failed";return false;}struct curl_slist* headers = nullptr;headers = curl_slist_append(headers, ("Authorization: Bearer " + api_key).c_str());headers = curl_slist_append(headers, "Content-Type: application/json");StreamState st;curl_easy_setopt(curl, CURLOPT_URL, "https://api.deepseek.com/chat/completions");curl_easy_setopt(curl, CURLOPT_HTTPHEADER, headers);curl_easy_setopt(curl, CURLOPT_POSTFIELDS, body.c_str());curl_easy_setopt(curl, CUR

登录后可评论,请前往 登录 或 注册