All Products
Search
Document Center

Alibaba Cloud Model Studio:Ringkasan dan enkripsi penalaran

Last Updated:Nov 16, 2026

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.

APIParameter pengaktifanField ringkasanField terenkripsi
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": "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.