Skip to main content

Resumo e criptografia do raciocínio

O Qwen4-Max retorna um resumo exibível e o raciocínio completo criptografado para restaurar o histórico em conversas com vários turnos.

Modelo compatível: qwen4-max.

Como funciona

Por padrão, o raciocínio completo é retornado. Quando ativado, o raciocínio original deixa de ser retornado em texto simples: o resumo serve para exibição e o conteúdo criptografado para restaurar o histórico. O resumo e a criptografia são ativados juntos. O conteúdo criptografado pode estar ausente se não houver raciocínio ou se a criptografia falhar. O resumo pode estar ausente ou incompleto; o raciocínio original continua sem ser retornado em texto simples. Ative esta função em cada solicitação e reenvie o conteúdo criptografado do histórico sem alterações para restaurar o raciocínio correspondente. Entradas de texto e multimodais usam os mesmos parâmetros. A criptografia armazena apenas o raciocínio; preserve também imagens, vídeos e outras entradas anteriores. Guarde cada segmento criptografado com sua mensagem assistant, inclusive em turnos com ferramentas. Ative enable_thinking=true em Chat Completions e DashScope e use preserve_thinking=true para continuar com o histórico criptografado. Responses e Anthropic Messages usam seus próprios parâmetros de raciocínio.

Ativar o recurso

Os exemplos usam Pequim. Substitua WorkspaceId pelo ID do seu workspace e configure DASHSCOPE_API_KEY.
APIParâmetro de ativaçãoCampo de resumoCampo criptografado
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": "Calcule 17×23."
    }
  ],
  "enable_thinking": true,
  "thinking_display": "summarized",
  "preserve_thinking": true
}'

Respostas e streaming

Chat Completions envia deltas do resumo em choices[i].delta.reasoning_content, depois um quadro completo e separado de encrypted_content, texto ou chamadas de ferramentas e a conclusão. Os campos sem streaming ficam em choices[i].message. Não descarte o quadro criptografado por estar sem texto nem crie uma mensagem assistant separada para ele. O item reasoning de Responses contém summary (elementos summary_text) e encrypted_content. O resumo chega incrementalmente; o conteúdo criptografado chega no evento de conclusão do item e na response final. Use o snapshot concluído para recuperar a criptografia sem adicionar o resumo duas vezes. O bloco thinking de Anthropic Messages contém o resumo thinking e a signature criptografada. O streaming envia primeiro thinking_delta, depois signature_delta completo; texto ou ferramentas vêm após o fechamento do bloco. A signature pode estar vazia se a criptografia falhar ou não houver raciocínio. Os campos DashScope ficam em output.choices[i].message, na mesma ordem de Chat Completions. Coloque o conteúdo criptografado em encrypted_content, não em content[].text. O finish_reason intermediário é a string "null" e o final é "stop". usage é cumulativo; não o some repetidamente.

Conversas com vários turnos

Preserve o conteúdo criptografado completo ao reenviar o histórico. O resumo pode ser omitido; o array summary do Responses pode ficar vazio.
  • Chat Completions
  • Responses
  • Anthropic Messages
  • DashScope
Envie os parâmetros não padrão do SDK Python OpenAI enable_thinking, thinking_display e preserve_thinking por 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 = [
    "Calcule 17×23.",
    "Agora some 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"])

Cobrança

Não há cobrança adicional por este recurso. Aplicam-se as regras existentes de cobrança de tokens de entrada e saída do modelo.