问答 JSON 抽取

一句话结论

用一个包含示例的英文 system_prompt，可以让 DeepSeek API 把问答文本抽取为 JSON；调用时还要设置 response_format 为 {'type': 'json_object'}。官方同时提醒，提示词必须包含 “json”，max_tokens 过小会使 JSON 在中途截断，JSON Output 也可能偶尔返回空内容。

适用场景

• 适合的任务：从考试题、问答记录或类似短文本中抽取固定的 question 和 answer 字段。

• 不适合的任务：需要严格 JSON Schema、字段校验或复杂嵌套结构的生产数据管道；本页只展示了基础 JSON 对象输出。

• 适用的模型版本：DeepSeek-V4.1-Flash；API 模型名为 deepseek-flash。官方首页说明，旧名称 deepseek-v4-flash 和 deepseek-v4-flash-vision-exp 的请求目前也由 DeepSeek-V4.1-Flash 提供服务。官方首次调用文档

• 适用的客户端、Agent 或 API：DeepSeek OpenAI 兼容 Chat Completions API；官方示例使用 Python OpenAI SDK。

• 推荐的推理档位和参数：本页未注明推理档位；设置 response_format={'type': 'json_object'}，并为完整 JSON 预留足够的 max_tokens。

可直接使用的内容

以下保留官方示例中的完整英文系统提示词。它包含任务说明、示例输入和示例 JSON 输出，可直接替换其中的字段名与示例内容。

The user will provide some exam text. Please parse the "question" and "answer" and output them in JSON format.

EXAMPLE INPUT:
Which is the highest mountain in the world? Mount Everest.

EXAMPLE JSON OUTPUT:
{
    "question": "Which is the highest mountain in the world?",
    "answer": "Mount Everest"
}

官方示例的用户输入：

Which is the longest river in the world? The Nile River.

官方示例输出：

{
    "question": "Which is the longest river in the world?",
    "answer": "The Nile River"
}

调用配置只需补上 response_format={'type': 'json_object'}；不要把它误解为固定 JSON Schema。客户端仍应解析并校验返回内容。

测试或工作流步骤

1. 将上面的系统提示词作为 system 消息，将待抽取文本作为 user 消息。

2. 使用 model="deepseek-flash" 调用 Chat Completions，并设置 response_format={'type': 'json_object'}。

3. 确认系统提示词或用户提示词包含单词 “json”，并在提示词中给出目标 JSON 形状示例。

4. 根据输出长度合理设置 max_tokens，避免 JSON 字符串输出到一半被截断。

5. 对 message.content 做 JSON 解析；若返回空内容，按官方建议调整提示词后重试，并在客户端保留空内容处理分支。

原始证据与数据

• 官方说明 JSON Output 用于让模型输出有效 JSON 字符串。

• 启用方式是将 response_format 设置为 {'type': 'json_object'}。

• 官方要求 system 或 user prompt 包含 “json”，并提供目标 JSON 格式示例。

• 官方要求合理设置 max_tokens，否则 JSON 可能在中途被截断；页面给出的示例代码没有显式填写 max_tokens。

• 官方警告 JSON Output 偶尔可能返回空内容，并建议通过修改提示词缓解。

• 页面完整 Python 示例的输入是 “Which is the longest river in the world? The Nile River.”，输出字段为 question 与 answer，答案值为 “The Nile River”。

适用边界

• json_object 只表达有效 JSON 对象输出，不等于服务端按固定 schema 约束字段、类型或枚举值；字段正确性仍需客户端校验。

• 官方示例只验证了单句问答和两个字符串字段，不能据此推断长文档、多条问答或复杂嵌套数据的稳定性。

• max_tokens 过小会造成截断；页面没有给出通用数值，应按输入长度和目标对象大小留出余量。

• 空内容是官方明确披露的偶发问题；修改提示词可能缓解，但页面没有给出保证成功的重试策略。

复现说明

1. 在 DeepSeek OpenAI 兼容 API 中使用 model="deepseek-flash"，将完整系统提示词和用户输入放入 messages。

2. 设置 response_format={'type': 'json_object'}，并根据预期输出长度设置 max_tokens。

3. 解析 response.choices[0].message.content，核对是否得到官方示例中的两个键及对应值。

4. 另测一个较小的 max_tokens 值，观察截断风险；对空 content 保留失败记录，不把一次成功当作稳定性证明。

5. 采集日期为 2026-09-16；模型名与版本映射以 官方首次调用文档 当前页面为准。