Qwen4-Max は表示用の思考要約と完全な思考の暗号文を返し、複数ターンの会話で過去の推論を復元します。
対応モデル:qwen4-max。
仕組み
デフォルトでは完全な思考を返します。有効にすると元の思考は平文では返されず、表示用の要約と履歴の復元用の完全な暗号文を返します。
要約と暗号文は同時に有効になります。思考が生成されない場合や暗号化に失敗した場合、暗号文がないことがあります。要約が欠落または不完全な場合も、元の思考は平文で返されません。
毎ターン本機能を有効にし、過去の暗号文をそのまま再送して対応する思考を復元します。
テキストとマルチモーダル入力のパラメーターは同じです。暗号文は思考のみを保存するため、過去の画像や動画なども保持してください。ツール呼び出しを含む各思考段階の暗号文を、所属する assistant メッセージとともに保存します。
Chat Completions と DashScope は enable_thinking=true で思考を有効にし、暗号化履歴を引き継ぐ際は preserve_thinking=true を指定します。Responses と Anthropic Messages は独自の思考パラメーターを使います。
有効化
以下の例はSingaporeリージョンを使用します。WorkspaceId を実際のワークスペース ID に置き換え、DASHSCOPE_API_KEY を設定してください。
| API | 有効化パラメーター | 要約フィールド | 暗号文フィールド |
|---|---|---|---|
| Chat Completions | thinking_display="summarized" | choices[i].message.reasoning_content | choices[i].message.encrypted_content |
| Responses | reasoning.summary="auto" | summary[].text | encrypted_content |
| Anthropic Messages | thinking.display="summarized" | thinking | signature |
| DashScope | parameters.thinking_display="summarized" | output.choices[i].message.reasoning_content | output.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 の順に返され、ブロック終了後に本文やツール呼び出しを返します。暗号化の失敗や思考がない場合、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
課金
追加料金はありません。モデルの通常の入力・出力トークン課金ルールが適用されます。