导航|地址|刷新
JSON Output | DeepSeek API Docs





跳到主要内容




DeepSeek API 文档


中文（中国）
English

中文（中国）

DeepSeek Platform














快速开始

首次调用 API

模型 & 价格

Token 用量计算

限速与隔离

错误码


接入 Agent 工具




API 指南

思考模式

多轮对话

对话前缀续写（Beta）

FIM 补全（Beta）

JSON Output

Tool Calls

上下文硬盘缓存

使用 Responses API

使用 Anthropic API



API 文档



新闻



其它资源


常见问题

更新日志










API 指南

JSON Output

本页总览




JSON Output

在很多场景下，用户需要让模型严格按照 JSON 格式来输出，以实现输出的结构化，便于后续逻辑进行解析。

DeepSeek 提供了 JSON Output 功能，来确保模型输出合法的 JSON 字符串。

注意事项​

设置 response_format 参数为 {'type': 'json_object'}。

用户传入的 system 或 user prompt 中必须含有 json 字样，并给出希望模型输出的 JSON 格式的样例，以指导模型来输出合法 JSON。

需要合理设置 max_tokens 参数，防止 JSON 字符串被中途截断。

在使用 JSON Output 功能时，API 有概率会返回空的 content。我们正在积极优化该问题，您可以尝试修改 prompt 以缓解此类问题。

样例代码​

这里展示了使用 JSON Output 功能的完整 Python 代码：


import json
from openai import OpenAI

client = OpenAI(
api_key="<your api key>",
base_url="https://api.deepseek.com",
)

system_prompt ="""
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"
}
"""

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

messages =[{"role":"system","content": system_prompt},
{"role":"user","content": user_prompt}]

response = client.chat.completions.create(
model="deepseek-v4-pro",
messages=messages,
response_format={
'type':'json_object'
}
)

print(json.loads(response.choices[0].message.content))





模型将会输出：


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












上一页

FIM 补全（Beta）

下一页

Tool Calls






注意事项

样例代码











微信公众号





社区

邮箱

Discord

Twitter



更多

GitHub




Copyright © 2026 DeepSeek, Inc.




------
导航页 打开网址