把文本提取为 JSON 字段

用 JSON Output 提取任务与星期，并区分响应 JSON 和 content 中的 JSON 字符串。

官方资料核对 2026-10-15示例代码，未进行真实接口实测

接入准备

已验证文本请求，准备自己的字段格式和校验规则。

准备环境变量

示例值需要替换为自己的凭证或资源 ID。代码在本机或服务端运行；密钥不应放进公开网页。

DEEPSEEK_API_KEY: 在 DeepSeek API keys 创建，只在本地终端或服务端设置。

export DEEPSEEK_API_KEY='replace_with_your_deepseek_key'

以上 export 适用于 macOS / Linux 的终端。按调用步骤保存代码文件，再在同一终端执行。

调用步骤

01
在提示中写明 JSON 和缺失值处理规则。
02
设置 response_format.type=json_object 后运行请求。
03
先解析 HTTP 响应，再用 JSON.parse 或 json.loads 解析 content，并校验字段类型。

调用 01

提取任务与星期

只提取原文明确给出的内容，不擅自将星期换成具体年月日。

POSThttps://api.deepseek.com/chat/completions

请求头

Authorization: Bearer ${DEEPSEEK_API_KEY}
Content-Type: application/json

参数说明

参数表可左右滑动，查看完整说明。

字段 / 位置	类型 / 必填	说明
`response_format.type`请求体	string必填	json_object 开启 JSON Output。
`messages`请求体	array必填	提示中包含 json，并给出字段示例。
`max_tokens`请求体	integer可选	为完整 JSON 预留输出空间。

调用代码

替换示例 ID 与请求体内容后运行。cURL 会报 HTTP 错误，业务状态还需按下方返回示例核对。

cat > request-body.json <<'JSON'
{
  "model": "deepseek-flash",
  "messages": [
    {
      "role": "system",
      "content": "提取任务并输出 JSON。格式示例：{\"task\":\"校对说明\",\"day\":\"周一\"}。缺失值填 null。只输出 JSON 对象。"
    },
    {
      "role": "user",
      "content": "周五检查新页面的参数表。"
    }
  ],
  "thinking": {
    "type": "disabled"
  },
  "response_format": {
    "type": "json_object"
  },
  "max_tokens": 512,
  "stream": false
}
JSON

# 执行后核对返回 JSON 的业务状态；HTTP 200 仍可能包含业务错误。
curl --silent --show-error --fail-with-body \
  --request POST \
  --url "https://api.deepseek.com/chat/completions" \
  --header "Authorization: Bearer ${DEEPSEEK_API_KEY}" \
  --header "Content-Type: application/json" \
  --data-binary @request-body.json

import json
import os
import re
import urllib.request
import urllib.error

def expand(value):
    return re.sub(r"\$\{([A-Z][A-Z0-9_]*)\}",
                  lambda match: os.environ[match.group(1)], value)

url = expand("https://api.deepseek.com/chat/completions")
headers = {
    "Authorization": expand("Bearer ${DEEPSEEK_API_KEY}"),
    "Content-Type": expand("application/json"),
}
body = {
    "model": "deepseek-flash",
    "messages": [
        {
            "role": "system",
            "content": "提取任务并输出 JSON。格式示例：{\"task\":\"校对说明\",\"day\":\"周一\"}。缺失值填 null。只输出 JSON 对象。",
        },
        {
            "role": "user",
            "content": "周五检查新页面的参数表。",
        },
    ],
    "thinking": {
        "type": "disabled",
    },
    "response_format": {
        "type": "json_object",
    },
    "max_tokens": 512,
    "stream": False,
}
data = json.dumps(body, ensure_ascii=False).encode("utf-8")
request = urllib.request.Request(url, data=data, headers=headers, method="POST")
try:
    with urllib.request.urlopen(request, timeout=30) as response:
        result = json.load(response)
except urllib.error.HTTPError as error:
    print(f"HTTP {error.code}: {error.read().decode('utf-8', errors='replace')}")
    raise SystemExit(1)
print(json.dumps(result, ensure_ascii=False, indent=2))

// Node.js 22+，保存为 request.mjs 后运行 node request.mjs
function expand(value) {
  return value.replace(/\$\{([A-Z][A-Z0-9_]*)\}/g, (_, name) => {
    if (!process.env[name]) throw new Error(`缺少环境变量 ${name}`);
    return process.env[name];
  });
}

const url = expand("https://api.deepseek.com/chat/completions");
const headers = Object.fromEntries(
  Object.entries({
  "Authorization": "Bearer ${DEEPSEEK_API_KEY}",
  "Content-Type": "application/json"
}).map(([key, value]) => [key, expand(value)])
);
const body = {
  "model": "deepseek-flash",
  "messages": [
    {
      "role": "system",
      "content": "提取任务并输出 JSON。格式示例：{\"task\":\"校对说明\",\"day\":\"周一\"}。缺失值填 null。只输出 JSON 对象。"
    },
    {
      "role": "user",
      "content": "周五检查新页面的参数表。"
    }
  ],
  "thinking": {
    "type": "disabled"
  },
  "response_format": {
    "type": "json_object"
  },
  "max_tokens": 512,
  "stream": false
};
const response = await fetch(url, {
  method: "POST",
  headers,
  body: JSON.stringify(body),
  signal: AbortSignal.timeout(30000),
});
const text = await response.text();
if (!response.ok) throw new Error(`HTTP ${response.status}: ${text}`);
const result = JSON.parse(text);
console.log(JSON.stringify(result, null, 2));

返回示例

虚构结构示意，content 自身仍是 JSON 字符串，非实测。以下为结构示意，非本站实测结果。

{
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "{\"task\":\"检查新页面的参数表\",\"day\":\"周五\"}"
      },
      "finish_reason": "stop"
    }
  ]
}

常见错误与排查

HTTP 401Key 无法认证。: 核对 DeepSeek Key 是否有效且未撤销。
HTTP 402账号余额不足。: 在官方控制台核对可用余额，不要不断重试。
HTTP 400 / 422参数或消息格式无效。: 检查 model、messages 和模式参数，按响应错误调整。
HTTP 429账号触发限流。: 降低并发并退避，不用更多 Key 规避账号限额。

调用注意

内容为空或 finish_reason=length 时不进入下游写入，先修正提示或输出预算。

JSON Output 条件 Chat Completions 请求参数

注意事项

JSON Output 不能保证字段事实正确，需要校验和必要的人为确认。
本例不调用表格、任务或其他外部业务接口。

核验来源

本站按官方资料整理本场景的必要调用步骤与代码，覆盖范围以本页列出的接口为准。官方资料用于追溯规范及查看变更。

01
创建 Key 与根地址核验日期 2026-10-15
02
价格与扣费核验日期 2026-10-15
03
错误码核验日期 2026-10-15
04
JSON Output 条件核验日期 2026-10-15
05
Chat Completions 请求参数核验日期 2026-10-15

DeepSeek API的其他调用手册

发送文本并取得模型回答读取当前可用模型列表

← 返回DeepSeek API的全部功能