全部產品
Search
文件中心

Alibaba Cloud Model Studio:思維鏈摘要與加密

更新時間:Nov 16, 2026

Qwen4-Max 傳回可顯示的思維鏈摘要和完整思維鏈的密文,用於多轮對話中恢復歷史思考。

適用模型:qwen4-max。

工作原理

默认傳回完整思維鏈。開啟本功能后,原始思維鏈不再以明文傳回,改為傳回摘要與完整密文。摘要用於顯示,密文用於恢復歷史思考。

摘要與加密同時開啟。未產生思考或加密失敗時,密文可能缺失;摘要可能缺失或不完整,接口仍不返回原始思維鏈。

每輪請求都需開啓本功能,並原樣回傳歷史密文,以恢復對應的歷史思考。

文本和多模态輸入使用相同參數;密文只保存思維鏈,圖片、影片等歷史輸入仍需保留。多段思考或工具呼叫時,每段密文随所属 assistant 訊息分別保存。

Chat Completions 和 DashScope 需開啟 enable_thinking=true;回传密文續推時設定 preserve_thinking=true。Responses 和 Anthropic Messages 使用各自的思考參數。

開啟方式

以下示例使用新加坡地域。將 WorkspaceId 替換為真實業務空間 ID,並設定 DASHSCOPE_API_KEY。

接口開啟參數摘要欄位密文欄位
Chat Completionsthinking_display="summarized"choices[i].message.reasoning_contentchoices[i].message.encrypted_content
Responsesreasoning.summary="auto"summary[].textencrypted_content
Anthropic Messagesthinking.display="summarized"thinkingsignature
DashScopeparameters.thinking_display="summarized"output.choices[i].message.reasoning_contentoutput.choices[i].message.encrypted_content

Chat Completions

curl -X POST "https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1/chat/completions" \
  -H "Authorization: Bearer $DASHSCOPE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "qwen4-max",
  "messages": [
    {
      "role": "user",
      "content": "請計算 17×23。"
    }
  ],
  "enable_thinking": true,
  "thinking_display": "summarized",
  "preserve_thinking": true
}'

Responses

curl -X POST "https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1/responses" \
  -H "Authorization: Bearer $DASHSCOPE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "qwen4-max",
  "input": "請計算 17×23。",
  "reasoning": {
    "summary": "auto"
  }
}'

Anthropic Messages

curl -X POST "https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/apps/anthropic/v1/messages" \
  -H "x-api-key: $DASHSCOPE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "qwen4-max",
  "max_tokens": 2048,
  "thinking": {
    "type": "enabled",
    "budget_tokens": 1024,
    "display": "summarized"
  },
  "messages": [
    {
      "role": "user",
      "content": "請計算 17×23。"
    }
  ]
}'

DashScope

curl -X POST "https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/services/aigc/multimodal-generation/generation" \
  -H "Authorization: Bearer $DASHSCOPE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "qwen4-max",
  "input": {
    "messages": [
      {
        "role": "user",
        "content": [
          {
            "text": "請計算 17×23。"
          }
        ]
      }
    ]
  },
  "parameters": {
    "result_format": "message",
    "incremental_output": false,
    "enable_thinking": true,
    "thinking_display": "summarized",
    "preserve_thinking": true
  }
}'

傳回與串流處理

Chat Completions 串流顺序:choices[i].delta.reasoning_content 摘要增量 → 獨立 encrypted_content 密文影格 → 正文或工具呼叫 → 结束。非串流欄位位于 choices[i].message。密文一次傳回,不要因文本為空而過濾密文影格,也不要為密文單獨创建 assistant 訊息。

Responses 的 reasoning item 包含 summary(summary_text 元素)和 encrypted_content。摘要按文本增量傳回,密文在 reasoning item 完成事件及最終 response 中傳回;可从完成快照补齐密文,不要重复追加摘要。

Anthropic Messages 的 thinking block 包含 thinking 摘要和 signature 密文。串流先傳回 thinking_delta,再傳回完整 signature_delta,關閉 thinking block 后傳回正文或工具呼叫;未产生思考或加密失败時 signature 可能為空字符串。

DashScope 欄位位于 output.choices[i].message,串流顺序與 Chat Completions 一致。密文放在 encrypted_content,不能放进 content[].text。中間影格的 finish_reason 為字符串 "null",最終為 "stop";usage 為累計值,不要重复累加。

多轮對話

回傳歷史時保留完整密文;摘要可省略,Responses 的 summary 可設爲空數組。

Chat Completions

OpenAI Python SDK 的非標準參數 enable_thinking、thinking_display、preserve_thinking 通過 extra_body 傳入。

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["DASHSCOPE_API_KEY"],
    base_url="https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1",
)
questions = [
    "請計算 17×23。",
    "再加 9。"
]
history = []

for turn, question in enumerate(questions, start=1):
    history.append({"role": "user", "content": question})
    response = client.chat.completions.create(
        model="qwen4-max",
        messages=history,
        max_tokens=8192,
        stream=False,
        extra_body={
            "enable_thinking": True,
            "thinking_display": "summarized",
            "preserve_thinking": True,
        },
    )
    assistant_message = response.choices[0].message.model_dump(exclude_none=True)
    history.append(assistant_message)
    print(f"Turn {turn}")
    print("Summary:", assistant_message.get("reasoning_content", ""))
    print("Answer:", assistant_message["content"])
const questions = [
    "請計算 17×23。",
    "再加 9。"
];
const history = [];
const endpoint = "https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1/chat/completions";

for (const [index, question] of questions.entries()) {
  history.push({ role: "user", content: question });
  const httpResponse = await fetch(endpoint, {
    method: "POST",
    headers: { "Authorization": `Bearer ${process.env.DASHSCOPE_API_KEY}`, "Content-Type": "application/json" },
    body: JSON.stringify({ model: "qwen4-max", messages: history, max_tokens: 8192, stream: false, enable_thinking: true, thinking_display: "summarized", preserve_thinking: true }),
  });
  if (!httpResponse.ok) throw new Error(await httpResponse.text());
  const response = await httpResponse.json();
  const assistantMessage = response.choices[0].message;
  history.push(assistantMessage);
  console.log(`Turn ${index + 1}`);
  console.log("Summary:", assistantMessage.reasoning_content ?? "");
  console.log("Answer:", assistantMessage.content);
}
set -euo pipefail

history='[]'
questions=(
  '請計算 17×23。'
  '再加 9。'
)

for question in "${questions[@]}"; do
  history=$(jq --arg question "$question" '. + [{role: "user", content: $question}]' <<< "$history")
  request=$(jq -n --argjson history "$history" '{model: "qwen4-max", messages: $history, max_tokens: 8192, stream: false, enable_thinking: true, thinking_display: "summarized", preserve_thinking: true}')
  response=$(curl --fail-with-body -sS "https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1/chat/completions" \
    -H "Authorization: Bearer $DASHSCOPE_API_KEY" \
    -H "Content-Type: application/json" \
    --data "$request")
  history=$(jq -n --argjson history "$history" --argjson response "$response" \
    '$history + [$response.choices[0].message]')
  printf '%s\n' "$response" | jq '.choices[0].message | {summary: .reasoning_content, answer: .content}'
done

Responses

設置 reasoning.summary="auto" 開啓摘要與加密。下例使用 store=false,由客戶端保存歷史。

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["DASHSCOPE_API_KEY"],
    base_url="https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1",
)
questions = [
    "請計算 17×23。",
    "再加 9。"
]
history = []

for turn, question in enumerate(questions, start=1):
    history.append({"role": "user", "content": question})
    response = client.responses.create(
        model="qwen4-max",
        input=history,
        reasoning={"effort": "medium", "summary": "auto"},
        max_output_tokens=8192,
        store=False,
        stream=False,
    )
    output_items = [item.model_dump(exclude_none=True) for item in response.output]
    history.extend(output_items)
    print(f"Turn {turn}")
    for item in output_items:
        if item["type"] == "reasoning":
            print("Summary:", "".join(part["text"] for part in (item.get("summary") or [])))
    print("Answer:", response.output_text)
const questions = [
    "請計算 17×23。",
    "再加 9。"
];
const history = [];
const endpoint = "https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1/responses";

for (const [index, question] of questions.entries()) {
  history.push({ role: "user", content: question });
  const httpResponse = await fetch(endpoint, {
    method: "POST",
    headers: { "Authorization": `Bearer ${process.env.DASHSCOPE_API_KEY}`, "Content-Type": "application/json" },
    body: JSON.stringify({ model: "qwen4-max", input: history, reasoning: { effort: "medium", summary: "auto" }, max_output_tokens: 8192, store: false, stream: false }),
  });
  if (!httpResponse.ok) throw new Error(await httpResponse.text());
  const response = await httpResponse.json();
  history.push(...response.output);
  console.log(`Turn ${index + 1}`);
  for (const item of response.output) {
    if (item.type === "reasoning") console.log("Summary:", (item.summary ?? []).map(part => part.text).join(""));
    if (item.type === "message") console.log("Answer:", item.content.filter(part => part.type === "output_text").map(part => part.text).join(""));
  }
}
set -euo pipefail

history='[]'
questions=(
  '請計算 17×23。'
  '再加 9。'
)

for question in "${questions[@]}"; do
  history=$(jq --arg question "$question" '. + [{role: "user", content: $question}]' <<< "$history")
  request=$(jq -n --argjson history "$history" '{model: "qwen4-max", input: $history, reasoning: {effort: "medium", summary: "auto"}, max_output_tokens: 8192, store: false, stream: false}')
  response=$(curl --fail-with-body -sS "https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1/responses" \
    -H "Authorization: Bearer $DASHSCOPE_API_KEY" \
    -H "Content-Type: application/json" \
    --data "$request")
  history=$(jq -n --argjson history "$history" --argjson response "$response" \
    '$history + $response.output')
  printf '%s\n' "$response" | jq '{summary: [.output[] | select(.type == "reasoning") | .summary[].text], answer: [.output[] | select(.type == "message") | .content[] | select(.type == "output_text") | .text]}'
done

Anthropic Messages

import os
import anthropic

client = anthropic.Anthropic(
    api_key=os.environ["DASHSCOPE_API_KEY"],
    base_url="https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/apps/anthropic",
)
questions = [
    "請計算 17×23。",
    "再加 9。"
]
history = []

for turn, question in enumerate(questions, start=1):
    history.append({"role": "user", "content": question})
    response = client.messages.create(
        model="qwen4-max",
        messages=history,
        max_tokens=8192,
        thinking={"type": "enabled", "budget_tokens": 4096, "display": "summarized"},
        stream=False,
    )
    content_blocks = [block.model_dump(exclude_none=True) for block in response.content]
    history.append({"role": "assistant", "content": content_blocks})
    print(f"Turn {turn}")
    for block in content_blocks:
        if block["type"] == "thinking":
            print("Summary:", block["thinking"])
        elif block["type"] == "text":
            print("Answer:", block["text"])
const questions = [
    "請計算 17×23。",
    "再加 9。"
];
const history = [];
const endpoint = "https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/apps/anthropic/v1/messages";

for (const [index, question] of questions.entries()) {
  history.push({ role: "user", content: question });
  const httpResponse = await fetch(endpoint, {
    method: "POST",
    headers: { "x-api-key": process.env.DASHSCOPE_API_KEY, "anthropic-version": "2023-06-01", "Content-Type": "application/json" },
    body: JSON.stringify({ model: "qwen4-max", messages: history, max_tokens: 8192, thinking: { type: "enabled", budget_tokens: 4096, display: "summarized" }, stream: false }),
  });
  if (!httpResponse.ok) throw new Error(await httpResponse.text());
  const response = await httpResponse.json();
  history.push({ role: "assistant", content: response.content });
  console.log(`Turn ${index + 1}`);
  for (const block of response.content) {
    if (block.type === "thinking") console.log("Summary:", block.thinking);
    if (block.type === "text") console.log("Answer:", block.text);
  }
}
set -euo pipefail

history='[]'
questions=(
  '請計算 17×23。'
  '再加 9。'
)

for question in "${questions[@]}"; do
  history=$(jq --arg question "$question" '. + [{role: "user", content: $question}]' <<< "$history")
  request=$(jq -n --argjson history "$history" '{model: "qwen4-max", messages: $history, max_tokens: 8192, thinking: {type: "enabled", budget_tokens: 4096, display: "summarized"}, stream: false}')
  response=$(curl --fail-with-body -sS "https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/apps/anthropic/v1/messages" \
    -H "x-api-key: $DASHSCOPE_API_KEY" -H "anthropic-version: 2023-06-01" \
    -H "Content-Type: application/json" \
    --data "$request")
  history=$(jq -n --argjson history "$history" --argjson response "$response" \
    '$history + [{role: "assistant", content: $response.content}]')
  printf '%s\n' "$response" | jq '{summary: [.content[] | select(.type == "thinking") | .thinking], answer: [.content[] | select(.type == "text") | .text]}'
done

DashScope

import json
import os
from urllib.request import Request, urlopen

questions = [
    "請計算 17×23。",
    "再加 9。"
]
history = []

for turn, question in enumerate(questions, start=1):
    history.append({"role": "user", "content": [{"text": question}]})
    body = {
        "model": "qwen4-max",
        "input": {"messages": history},
        "parameters": {
            "result_format": "message",
            "incremental_output": False,
            "enable_thinking": True,
            "thinking_display": "summarized",
            "preserve_thinking": True,
            "max_tokens": 8192,
        },
    }
    request = Request(
        "https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/services/aigc/multimodal-generation/generation",
        data=json.dumps(body).encode("utf-8"),
        headers={
            "Authorization": "Bearer " + os.environ["DASHSCOPE_API_KEY"],
            "Content-Type": "application/json",
        },
        method="POST",
    )
    with urlopen(request, timeout=120) as http_response:
        response = json.load(http_response)
    assistant_message = response["output"]["choices"][0]["message"]
    history.append(assistant_message)
    print(f"Turn {turn}")
    print("Summary:", assistant_message.get("reasoning_content", ""))
    print("Answer:", "".join(part.get("text", "") for part in assistant_message["content"]))
const questions = [
    "請計算 17×23。",
    "再加 9。"
];
const history = [];
const endpoint = "https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/services/aigc/multimodal-generation/generation";

for (const [index, question] of questions.entries()) {
  history.push({ role: "user", content: [{ text: question }] });
  const httpResponse = await fetch(endpoint, {
    method: "POST",
    headers: { "Authorization": `Bearer ${process.env.DASHSCOPE_API_KEY}`, "Content-Type": "application/json" },
    body: JSON.stringify({ model: "qwen4-max", input: { messages: history }, parameters: { result_format: "message", incremental_output: false, enable_thinking: true, thinking_display: "summarized", preserve_thinking: true, max_tokens: 8192 } }),
  });
  if (!httpResponse.ok) throw new Error(await httpResponse.text());
  const response = await httpResponse.json();
  const assistantMessage = response.output.choices[0].message;
  history.push(assistantMessage);
  console.log(`Turn ${index + 1}`);
  console.log("Summary:", assistantMessage.reasoning_content ?? "");
  console.log("Answer:", assistantMessage.content.map(part => part.text ?? "").join(""));
}
set -euo pipefail

history='[]'
questions=(
  '請計算 17×23。'
  '再加 9。'
)

for question in "${questions[@]}"; do
  history=$(jq --arg question "$question" '. + [{role: "user", content: [{text: $question}]}]' <<< "$history")
  request=$(jq -n --argjson history "$history" '{model: "qwen4-max", input: {messages: $history}, parameters: {result_format: "message", incremental_output: false, enable_thinking: true, thinking_display: "summarized", preserve_thinking: true, max_tokens: 8192}}')
  response=$(curl --fail-with-body -sS "https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/services/aigc/multimodal-generation/generation" \
    -H "Authorization: Bearer $DASHSCOPE_API_KEY" \
    -H "Content-Type: application/json" \
    --data "$request")
  history=$(jq -n --argjson history "$history" --argjson response "$response" \
    '$history + [$response.output.choices[0].message]')
  printf '%s\n' "$response" | jq '.output.choices[0].message | {summary: .reasoning_content, answer: [.content[].text]}'
done

計費說明

本功能不額外收费,按模型原有輸入、輸出 Token 計費規則計費。