logo

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请求体。

  1. Authorization: Bearer <你的API_KEY>
  2. 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上可以直接安装:

  1. sudo apt install libcurl4-openssl-dev nlohmann-json3-dev

在macOS上使用Homebrew安装:

  1. brew install curl nlohmann-json

如果不想安装系统包,可以从nlohmann/json的发布页面下载单头文件 json.hpp,放入项目的 include/nlohmann/ 目录。推荐的项目结构如下:

  1. deepseek_demo/
  2. ├── CMakeLists.txt
  3. ├── main.cpp
  4. └── include/
  5. └── nlohmann/
  6. └── json.hpp

CMakeLists.txt 的内容如下,其中 target_include_directories 让编译器能找到 nlohmann/json.hpp:

  1. cmake_minimum_required(VERSION 3.16)
  2. project(deepseek_cpp_demo LANGUAGES CXX)
  3. set(CMAKE_CXX_STANDARD 17)
  4. set(CMAKE_CXX_STANDARD_REQUIRED ON)
  5. find_package(CURL REQUIRED)
  6. add_executable(deepseek_demo main.cpp)
  7. target_include_directories(deepseek_demo PRIVATE ${CMAKE_SOURCE_DIR}/include)
  8. 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时,可以直接编译:

  1. g++ -std=c++17 main.cpp -Iinclude -lcurl -o deepseek_demo

四、非流式调用完整示例

非流式调用会等待模型生成完整回答后一次性返回。下面的代码将网络错误、HTTP状态码错误和JSON结构错误分开处理。

  1. #include <curl/curl.h>
  2. #include <nlohmann/json.hpp>
  3. #include <cstdlib>
  4. #include <iostream>
  5. #include <string>
  6. using json = nlohmann::json;
  7. static size_t WriteToString(char* ptr, size_t size, size_t nmemb, void* userdata) {
  8. auto* out = static_cast<std::string*>(userdata);
  9. out->append(ptr, size * nmemb);
  10. return size * nmemb;
  11. }
  12. // 成功时返回 true 并写入 answer;失败时把原因写入 error
  13. bool ChatOnce(const std::string& api_key,
  14. const std::string& prompt,
  15. std::string& answer,
  16. std::string& error) {
  17. json payload = {
  18. {"model", "deepseek-chat"},
  19. {"messages", json::array({
  20. {{"role", "user"}, {"content", prompt}}
  21. })},
  22. {"stream", false}
  23. };
  24. const std::string body = payload.dump();
  25. CURL* curl = curl_easy_init();
  26. if (!curl) {
  27. error = "curl_easy_init failed";
  28. return false;
  29. }
  30. struct curl_slist* headers = nullptr;
  31. headers = curl_slist_append(headers, ("Authorization: Bearer " + api_key).c_str());
  32. headers = curl_slist_append(headers, "Content-Type: application/json");
  33. std::string response_body;
  34. curl_easy_setopt(curl, CURLOPT_URL, "https://api.deepseek.com/chat/completions");
  35. curl_easy_setopt(curl, CURLOPT_HTTPHEADER, headers);
  36. curl_easy_setopt(curl, CURLOPT_POSTFIELDS, body.c_str());
  37. curl_easy_setopt(curl, CURLOPT_WRITEFUNCTION, WriteToString);
  38. curl_easy_setopt(curl, CURLOPT_WRITEDATA, &response_body);
  39. curl_easy_setopt(curl, CURLOPT_CONNECTTIMEOUT, 10L);
  40. curl_easy_setopt(curl, CURLOPT_TIMEOUT, 60L);
  41. CURLcode res = curl_easy_perform(curl);
  42. long status = 0;
  43. if (res == CURLE_OK) {
  44. curl_easy_getinfo(curl, CURLINFO_RESPONSE_CODE, &status);
  45. }
  46. curl_slist_free_all(headers);
  47. curl_easy_cleanup(curl);
  48. if (res != CURLE_OK) {
  49. error = std::string("网络错误: ") + curl_easy_strerror(res);
  50. return false;
  51. }
  52. if (status != 200) {
  53. error = "HTTP " + std::to_string(status) + ": " + response_body;
  54. return false;
  55. }
  56. try {
  57. json resp = json::parse(response_body);
  58. // choices 是数组,必须用 [0] 取第一个元素
  59. if (!resp.contains("choices") || !resp["choices"].is_array() || resp["choices"].empty()) {
  60. error = "响应中没有 choices: " + response_body;
  61. return false;
  62. }
  63. const json& choice = resp["choices"][0];
  64. if (!choice.contains("message") || !choice["message"].contains("content")) {
  65. error = "choices[0] 中没有 message.content: " + response_body;
  66. return false;
  67. }
  68. answer = choice["message"]["content"].get<std::string>();
  69. return true;
  70. } catch (const json::exception& e) {
  71. error = std::string("JSON 解析失败: ") + e.what();
  72. return false;
  73. }
  74. }
  75. int main() {
  76. const char* env_key = std::getenv("DEEPSEEK_API_KEY");
  77. if (!env_key || *env_key == '\0') {
  78. std::cerr << "请先设置环境变量 DEEPSEEK_API_KEY" << std::endl;
  79. return 1;
  80. }
  81. // 整个程序只需调用一次,且要在创建任何线程之前调用
  82. curl_global_init(CURL_GLOBAL_DEFAULT);
  83. std::string answer;
  84. std::string error;
  85. if (ChatOnce(env_key, "用一句话介绍 C++", answer, error)) {
  86. std::cout << answer << std::endl;
  87. } else {
  88. std::cerr << "调用失败: " << error << std::endl;
  89. }
  90. curl_global_cleanup();
  91. return 0;
  92. }

编译运行前,先在终端设置环境变量:

  1. export DEEPSEEK_API_KEY="sk-xxxxxxxx"
  2. ./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 换行
}

  1. const std::string prefix = "data:";
  2. if (line.compare(0, prefix.size(), prefix) != 0) {
  3. return; // 跳过空行(事件分隔符)和其他字段
  4. }
  5. std::string payload = line.substr(prefix.size());
  6. if (!payload.empty() && payload[0] == ' ') {
  7. payload.erase(0, 1);
  8. }
  9. if (payload == "[DONE]") {
  10. st.done = true;
  11. return;
  12. }
  13. try {
  14. json chunk = json::parse(payload);
  15. if (chunk.contains("error")) {
  16. st.error = chunk["error"].dump();
  17. return;
  18. }
  19. if (!chunk.contains("choices") || !chunk["choices"].is_array() || chunk["choices"].empty()) {
  20. return;
  21. }
  22. const json& choice = chunk["choices"][0];
  23. if (choice.contains("delta") && choice["delta"].contains("content")) {
  24. const json& piece = choice["delta"]["content"];
  25. if (piece.is_string()) {
  26. std::cout << piece.get<std::string>() << std::flush;
  27. }
  28. }
  29. } catch (const json::exception& e) {
  30. st.error = std::string("解析 SSE 数据失败: ") + e.what() + " 原始数据: " + payload;
  31. }

}

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);

  1. size_t pos = 0;
  2. while (!st->done && (pos = st->buffer.find('\n')) != std::string::npos) {
  3. std::string line = st->buffer.substr(0, pos);
  4. st->buffer.erase(0, pos + 1);
  5. HandleLine(*st, line);
  6. }
  7. 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();

  1. CURL* curl = curl_easy_init();
  2. if (!curl) {
  3. error = "curl_easy_init failed";
  4. return false;
  5. }
  6. struct curl_slist* headers = nullptr;
  7. headers = curl_slist_append(headers, ("Authorization: Bearer " + api_key).c_str());
  8. headers = curl_slist_append(headers, "Content-Type: application/json");
  9. StreamState st;
  10. curl_easy_setopt(curl, CURLOPT_URL, "https://api.deepseek.com/chat/completions");
  11. curl_easy_setopt(curl, CURLOPT_HTTPHEADER, headers);
  12. curl_easy_setopt(curl, CURLOPT_POSTFIELDS, body.c_str());
  13. curl_easy_setopt(curl, CUR

发表评论

活动