Qwen4-Max mengembalikan ringkasan penalaran untuk ditampilkan dan penalaran lengkap terenkripsi untuk memulihkan riwayat dalam percakapan multi-putaran.
Model yang didukung: qwen4-max.
Cara kerja
Secara default, penalaran lengkap dikembalikan. Setelah diaktifkan, penalaran asli tidak lagi dikembalikan sebagai teks biasa; ringkasan digunakan untuk tampilan dan teks terenkripsi untuk memulihkan riwayat.
Ringkasan dan ciphertext diaktifkan bersama. Ciphertext dapat tidak tersedia jika penalaran tidak dihasilkan atau enkripsi gagal. Ringkasan dapat hilang atau tidak lengkap; penalaran mentah tetap tidak dikembalikan.
Aktifkan fitur ini pada setiap permintaan dan kirim kembali ciphertext historis tanpa perubahan untuk memulihkan penalaran terkait.
Input teks dan multimodal memakai parameter yang sama. Enkripsi hanya menyimpan penalaran; simpan juga gambar, video, dan input historis lainnya. Simpan setiap segmen terenkripsi bersama pesan assistant yang terkait, termasuk putaran pemanggilan alat.
Aktifkan enable_thinking=true untuk Chat Completions dan DashScope serta gunakan preserve_thinking=true untuk meneruskan riwayat terenkripsi. Responses dan Anthropic Messages memakai parameter penalaran masing-masing.
Aktifkan fitur
Contoh menggunakan Singapura. Ganti WorkspaceId dengan ID ruang kerja Anda dan atur DASHSCOPE_API_KEY.
| API | Parameter pengaktifan | Field ringkasan | Field terenkripsi |
|---|---|---|---|
| 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": "Hitung 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": "Hitung 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": "Hitung 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": "Hitung 17×23."
}
]
}
]
},
"parameters": {
"result_format": "message",
"incremental_output": false,
"enable_thinking": true,
"thinking_display": "summarized",
"preserve_thinking": true
}
}'
Respons dan streaming
Chat Completions mengirim delta ringkasan di choices[i].delta.reasoning_content, lalu satu frame lengkap encrypted_content, teks atau pemanggilan alat, dan penyelesaian. Field non-streaming ada di choices[i].message. Jangan membuang frame terenkripsi karena teksnya kosong atau membuat pesan assistant terpisah untuknya.
Item reasoning Responses berisi summary (elemen summary_text) dan encrypted_content. Ringkasan dikirim bertahap; teks terenkripsi dikirim pada peristiwa penyelesaian item reasoning dan response akhir. Gunakan snapshot selesai untuk melengkapi enkripsi tanpa menambahkan ringkasan dua kali.
Blok thinking Anthropic Messages berisi ringkasan thinking dan signature terenkripsi. Streaming mengirim thinking_delta, lalu signature_delta lengkap; teks atau pemanggilan alat muncul setelah blok ditutup. Signature bisa kosong jika enkripsi gagal atau tidak ada penalaran.
Field DashScope ada di output.choices[i].message dengan urutan streaming yang sama seperti Chat Completions. Letakkan teks terenkripsi di encrypted_content, bukan content[].text. finish_reason antara adalah string "null", nilai akhir "stop". usage streaming bersifat kumulatif; jangan menjumlahkannya berulang kali.
Percakapan multi-putaran
Pertahankan ciphertext lengkap saat mengirim kembali riwayat. Ringkasan dapat dihilangkan; array summary pada Responses dapat kosong.
Chat Completions
Kirim parameter nonstandar OpenAI Python SDK enable_thinking, thinking_display, dan preserve_thinking melalui 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 = [
"Hitung 17×23.",
"Lalu tambahkan 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 = [
"Hitung 17×23.",
"Lalu tambahkan 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=(
'Hitung 17×23.'
'Lalu tambahkan 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
Tetapkan reasoning.summary="auto" untuk mengaktifkan ringkasan dan enkripsi. Contoh ini menggunakan store=false dan menyimpan riwayat di klien.
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 = [
"Hitung 17×23.",
"Lalu tambahkan 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 = [
"Hitung 17×23.",
"Lalu tambahkan 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=(
'Hitung 17×23.'
'Lalu tambahkan 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 = [
"Hitung 17×23.",
"Lalu tambahkan 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 = [
"Hitung 17×23.",
"Lalu tambahkan 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=(
'Hitung 17×23.'
'Lalu tambahkan 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 = [
"Hitung 17×23.",
"Lalu tambahkan 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 = [
"Hitung 17×23.",
"Lalu tambahkan 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=(
'Hitung 17×23.'
'Lalu tambahkan 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
Penagihan
Tidak ada biaya tambahan untuk fitur ini. Aturan penagihan token input dan output model tetap berlaku.