Skip to main content

思考の要約と暗号化

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 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
  • Responses
  • Anthropic Messages
  • DashScope
curl
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
}'

返却とストリーミング

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
  • Responses
  • Anthropic Messages
  • DashScope
OpenAI Python SDK の非標準パラメーター enable_thinking、thinking_display、preserve_thinking は extra_body で渡します。
Python
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"])

課金

追加料金はありません。モデルの通常の入力・出力トークン課金ルールが適用されます。