Tradução de apoio para consulta. Código e identificadores técnicos preservados. Consultar referência original ↗

Retrieve response

Fonte: https://docs.qwencloud.com/api-reference/chat/retrieve-response - extraído do HTML público arquivado.

Não, não, não. Modo compatível/v1/respostas/{resposta_id} Python Python Entendido.

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.getenv("DASHSCOPE_API_KEY"),
    base_url="https://maas.qwencloudapi.com/compatible-mode/v1",
)

response = client.responses.retrieve("resp_xxx")
print (response)

200 404 Entendido.

{
  "background": false,
  "completed_at": 1778676420,
  "created_at": 1778676418,
  "frequency_penalty": 0,
  "id": "resp_801bc2c4-93d9-910f-b35d-5274f5a737c1",
  "metadata": {},
  "model": "qwen-plus",
  "object": "response",
  "output": [
    {
      "content": [
        {
          "annotations": [],
          "text": "Hello! Nice to meet you. How can I help you today?",
          "type": "output_text"
        }
      ],
      "id": "msg_8c54756c-9b65-4a95-81d7-4276d91406db",
      "role": "assistant",
      "status": "completed",
      "type": "message"
    }
  ],
  "parallel_tool_calls": true,
  "presence_penalty": 0,
  "service_tier": "default",
  "status": "completed",
  "store": true,
  "temperature": 1,
  "tool_choice": "auto",
  "tools": [],
  "top_logprobs": 0,
  "top_p": 1,
  "usage": {
    "input_tokens": 45,
    "input_tokens_details": {
      "cached_tokens": 0
    },
    "output_tokens": 63,
    "output_tokens_details": {
      "reasoning_tokens": 0
    },
    "total_tokens": 108
  }
}

Autorizações

Autorização string cabeçalho requerido Chave da API DashScope.

Parâmetros do Caminho

-Responda! string requerido A identificação da resposta para recuperar, no formato resp_xxx. Você pode obtê-lo da API de criação-resposta. Apenas IDs de resposta retornados por pedidos criados com store=true Pode ser recuperado.

Resposta

200-aplicação/json ID string A identificação única para esta resposta. É válido por 7 dias. Você pode usar este parâmetro no previous_response_id parâmetro para criar uma conversa multi-volta. criado_ em Número A data do Unix em segundos para este pedido. objeto enum<string> O tipo de objeto. O valor é response. Opções disponíveis: resposta. Situação enum<string> O status da geração de resposta. Opções disponíveis: completa, falhada, em progresso, cancelada, em espera, incompleta Modelo string A identificação do modelo que é usado para gerar a resposta. saída objeto[] Uma série de itens de saída gerados pelo modelo. O tipo e a ordem dos elementos na matriz dependem da resposta do modelo. Mostrar atributos infantis saída.type enum<string> O tipo de item de saída.

message Contém o conteúdo final de resposta gerado pelo modelo.
reasoningRetornou quando pensava em modoenable_thinking: true) está habilitado. Os símbolos de raciocinação são contados em output_tokens_details.reasoning_tokens e são cobrados como símbolos de raciocínio.
function_call:Devolvido quando uma ferramenta de função definida pelo usuário é usada. Você precisa lidar com a chamada de função e retornar o resultado.
web_search_call- Retornou quando o web_search A ferramenta é usada.
code_interpreter_call- Retornou quando o code_interpreter A ferramenta é usada.
web_extractor_call- Retornou quando o web_extractor A ferramenta é usada. Deve ser usado com o web_search Ferramenta.
web_search_image_call- Retornou quando o web_search_image A ferramenta é usada. Contém uma lista de imagens pesquisadas.
image_search_call- Retornou quando o image_search A ferramenta é usada. Contém uma lista de imagens semelhantes.
mcp_call- Retornou quando o mcp A ferramenta é usada. Contém o resultado da chamada de serviço MCP.
file_search_call- Retornou quando o file_search A ferramenta é usada. Contém a pesquisa e os resultados da base de conhecimento. Opções disponíveis: mensagem, razão, função_call, web_search_call, code_interpreter_call, web_extractor_call, web_search_image_call, image_search_call, mcp_call, file_search_call saída.id string O identificador único para o item de saída. Este campo está incluído em todos os tipos de itens de saída. Saída. Patrulha. enum<string> O papel da mensagem. O valor é assistant. Este campo só existe quando o tipo é message. Opções disponíveis: assistente saída. status enum<string> O status do item de saída. Opções disponíveis: completa, em progresso saída.nome string A ferramenta ou nome de função. Este campo existe quando o tipo é function_call, web_search_image_call, image_search_call, ou mcp_call. Por web_search_image_call e image_search_call, os valores são fixados como web_search_image e image_search, respectivamente. Por mcp_callO valor é o nome específico da função chamada no serviço MCP, como amap-maps-maps_geo. saída. Argumentos. string Os argumentos para a chamada de ferramentas, no formato de string JSON. Este campo existe quando o tipo é function_call, web_search_image_call, image_search_call, ou mcp_call. Você precisa analisar usando JSON.parse() antes de usar.

Argumentos por tipo de ferramenta:

web_search_image_call: {"queries": ["search term 1", "search term 2"]}, onde consultas são uma lista de termos de busca gerados automaticamente pelo modelo.
image_search_call: {"img_idx": 0, "bbox": [0, 0, 1000, 1000]}, onde img_idx é o índice da imagem de entrada (começando de 0), e bbox é a caixa de coordenadas [x1, y1, x2, y2] para a área de busca, com uma faixa de 0-1000.
function_callUm objeto de argumento gerado de acordo com o esquema dos parâmetros de função definidos pelo usuário.
mcp_callUm objeto de discussão para a função chamada no serviço MCP.
O que é isso? string O identificador único para a chamada de função. Este campo só existe quando o tipo é function_call. Ao retornar o resultado da chamada, você deve usar esta identificação para associar o pedido com a resposta. saída.conteúdo objeto[] Uma variedade de conteúdo de mensagem. Este campo só existe quando o tipo é message. Mostrar atributos infantis Saída.Conteúdo.tipo. enum<string> O tipo de conteúdo. O valor é output_text. Opções disponíveis: texto de saída saída.conteúdo.texto string O conteúdo de texto que é gerado pelo modelo. Saída.Conteúdo. Anotações. objeto[] Uma série de anotações de texto. Normalmente, é um conjunto vazio. saída. resumo objeto[] Uma série de resumos de raciocínio. Este campo só existe quando o tipo é reasoning. Cada elemento contém um type campo com um valor de summary_text e um text campo que contém o texto sumário. Mostrar atributos infantis Saída. Resumo. Tipo. enum<string> Opções disponíveis: resumo_texto saída. resumo.texto. string saída. ação objeto A informação da ação de busca. Este campo só existe quando o tipo é web_search_call. Mostrar atributos infantis saída. ação. consulta. string A palavra-chave da pesquisa. saída. ação. tipo enum<string> O tipo de busca. O valor é search. Opções disponíveis: pesquisa saída. ação. fonte. objeto[] Uma lista de fontes de busca. Cada elemento contém um type -E um campo e um. url Campo. Mostrar atributos infantis saída. ação. fontes. tipo string saída. ação. fontes. url. string saída. código string O código que é gerado e executado pelo modelo. Este campo só existe quando o tipo é code_interpreter_call. saída. saída. saída. objeto[] Uma série de saídas de execução de código. Este campo só existe quando o tipo é code_interpreter_call. Cada elemento contém um type campo com um valor de logs e um logs campo que contém o registro de execução do código. Mostrar atributos infantis saída. saída. tipo. enum<string> Opções disponíveis: logs saída. saída. logs string
O que é isso? string O identificador do recipiente de intérprete de código. Este campo só existe quando o tipo é code_interpreter_call. É usado para associar múltiplas execuções de código na mesma sessão. Saída. Gol. string Uma descrição do objetivo de extração que explica o que a informação precisa ser extraída da página. Este campo só existe quando o tipo é web_extractor_call. saída. saída. string O resultado da chamada da ferramenta, em formato de string.
Quando o tipo é web_extractor_callEste é o resumo do conteúdo extraído da web.
Quando o tipo é web_search_image_call Ou image_search_call Esta é uma string JSON contendo uma série de resultados de busca de imagens. Cada elemento contém um title campo (título da imagem), a url campo (imagem URL), e um index campo (número de sequência).
Quando o tipo é mcp_callEste é o resultado da cadeia JSON retornado pelo serviço MCP. saída. Urls -Corda. Uma lista de URLs das páginas extraídas. Este campo só existe quando o tipo é web_extractor_call. saída.server_label string A etiqueta de serviço MCP. Este campo só existe quando o tipo é mcp_call. Identifica o serviço MCP usado para esta chamada. Saída. Consultas. -Corda. A lista de consultas usadas para recuperação de bases de conhecimento. Este campo só existe quando o tipo é file_search_call. Elementos de arranjo são cordas que representam pesquisas geradas pelo modelo. resultado. objeto[] Uma série de resultados de recuperação de base de conhecimento. Este campo só existe quando o tipo é file_search_call. Mostrar atributos infantis Resultado. Arquivo. string A identificação do documento correspondente. saída.results. nome do arquivo. string O nome do documento correspondente. resultado, resultados, pontuação, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, resultados, Número A pontuação de relevância da partida, variando de 0 a 1. Um valor maior indica maior relevância. saída.results.texto string Um trecho do conteúdo do documento. Chamadas paralelas booleano Se as chamadas de ferramentas paralelas estão habilitadas. Escolha de ferramentas string O valor do tool_choice parâmetro do pedido de eco. Valores válidos são auto, none, e required. Ferramentas objeto[] O conteúdo completo do parâmetro ferramentas do pedido de eco. A estrutura é a mesma que o parâmetro ferramentas no corpo de solicitação. Erro objeto nulo O objeto de erro que é devolvido quando o modelo falha em gerar uma resposta. Este campo é null sobre o sucesso. Mostrar atributos infantis error.código string O código de erro. Erro. Mensagem. string Uma mensagem de erro legível por humanos. uso objeto A informação de consumo para este pedido. Mostrar atributos infantis Use.input_tokens inteiro O número de fichas de entrada. Use. output_tokens inteiro O número de fichas que são saída pelo modelo. Use.Tokens. inteiro O número total de fichas consumidas. Esta é a soma de input_tokens e output_tokens. Use. objeto A classificação fina de fichas de entrada. Mostrar atributos infantis Use.input_tokens_details.cached_tokens inteiro O número de fichas que atingiram o esconderijo. Use.put_tokens_detalhes objeto A classificação de notas de saída. Mostrar atributos infantis Use. output_tokens_details. raciocinando_tokens inteiro O número de fichas no processo de pensar. Use.x_detalhes objeto[] Detalhou a ficha por tipo de faturamento. Mostrar atributos infantis Use.x_detalhes.input_tokens inteiro O número de fichas de entrada. Use.x_detalhes.put_tokens inteiro O número de fichas de saída pelo modelo. Use.x_detalhes.Tokens inteiro O número total de fichas consumidas, a soma de entradas e entradas. Use.x_details.x_billing_type string Consertado como response_api. Use.x_details.image_tokens inteiro O número de fichas de entrada de imagens. Retornado quando a entrada da imagem está incluída, equivalente a input_tokens_details.image_tokens. Use.x_detalhes.input_tokens_detalhes objeto Classificação fina e detalhes de fichas de entrada. Retornado para entrada multimodal ou quando o cache da sessão estiver ativado. Mostrar atributos infantis Use.x_details.input_tokens_details.text_tokens inteiro O número de fichas de texto. Use.x_detalhes.input_tokens_detalhes.image_tokens inteiro O número de fichas de entrada de imagens. Use.x_detalhes.input_tokens_detalhes.cached_tokens inteiro O número de fichas de cache. Use.x_detalhes.input_tokens_detalhes.cache_criação_intaction_tokens inteiro O número de fichas para as quais uma nova entrada de cache foi criada neste pedido. Use.x_detalhes.input_tokens_details.cache_criação objeto Detalhes da criação de cache. Mostrar atributos infantis Efeições, entradas, entradas, entradas, entradas, entradas, entradas, entradas, entradas, entradas, entradas, entradas, entradas, entradas, entradas, entradas, entradas, entradas, entradas, entradas, entradas, entradas, entradas, entradas, entradas, entradas, entradas, entradas, entradas, entradas, entradas, entradas, entradas, entradas, entradas, entradas, entradas, entradas, entradas, entradas, entradas, entradas, entradas, entradas, entradas, entradas, entradas, entradas, entradas, entradas, entradas, entradas, entradas, entradas, entradas, entradas, entradas, entradas, entradas, entradas, entradas, entradas, entradas, entradas, entradas, entradas, entradas, entradas, entradas, entradas, entradas, entradas, entradas, entradas, entradas, entradas, entradas, entradas, entradas, entradas, entradas, entradas, entradas, entradas, entradas, entradas, entradas, entradas, entradas, entradas, entradas, entradas, entradas, entradas, entradas, entradas, entradas, entradas, entradas, entradas, entradas, entradas, entradas, entradas, entradas, entradas, entradas, entradas, entradas, entradas, entradas, entradas, entradas, entradas, entradas, entradas, detalhes, detalhes, detalhes, detalhes, detalhes, detalhes, detalhes, detalhes, instruções, instruções, instruções, instruções, instruções, instruções, instruções, instruções, instruções, instruções, instruções, instruções, instruções, instruções, instruções, instruções, instruções, instruções, instruções, instruções, instruções, instruções, instruções, instruções, instruções, instruções, instruções, instruções, instruções, instruções, instruções, instruções, instruções, instruções, instruções, instruções, instruções, instruções, instruções, instruções, instruções, instruções, instruções, instruções, instruções, instruções, instruções, instruções, instruções, instruções, instruções, instruções, instruções, instruções, instruções, instruções, instruções, instruções, instruções, instruções, instruções, instruções, instruções, instruções, instruções, instruções, instruções, instruções, instruções, instruções, instruções, instruções, instruções, instruções, instruções, instruções, instruções, instruções, instruções, instruções, instruções, instruções, instruções, instruções, instruções, instruções, instruções, instruções, instruções, instruções, instruções, instruções, instruções, instruções, instruções, instruções, instruções, instruções, instruções, instruções, instruções, instruções, instruções, instruções, instruções, instruções, instruções, instruções, instruções, instruções, instruções, instruções, instruções, instruções, instruções, instruções, instruções, instruções, instruções, instruções, instruções, instruções, instruções, instruções, instruções, instruções, instruções, instruções, instruções, instruções, instruções, instruções, instruções, instruções, instruções, instruções, instruções, instruções, instruções, instruções, instruções, instruções, instruções, instruções, instruções, instruções, instruções, instruções, instruções, instruções, instruções, instruções, instruções, instruções, instruções, instruções, instruções, instruções, instruções, instruções, instruções, instruções, instruções, instruções, instruções, instruções, instruções, instruções, instruções, instruções, instruções, instruções, instruções, instruções, instruções, instruções, instruções, instruções, instruções, instruções, instruções, instruções, instruções, instruções, instruções, instruções, instruções, instruções, instruções, instruções, instruções, instruções, instruções, instruções, instruções, instruções, instruções, instruções, instruções, instruções, instruções, instruções, instruções, instruções, instruções, instruções, instruções, instruções, instruções, instruções, instruções, instruções, instruções, instruções, instruções, instruções, instruções, instruções, instruções, instruções, instruções, instruções, instruções, instruções, instruções, instruções, instruções, instruções, instruções, instruções, instruções, instruções, instruções, instruções, instruções, instruções, instruções, instruções, instruções, instruções, instruções, instruções, instruções, instruções, instruções, instruções, instruções, instruções, instruções, instruções, instruções, instruções, instruções, instruções, instruções, instruções, instruções, instruções, instruções inteiro O número de fichas criadas para o cache efêmero de 5 minutos. Use.x_details.input_tokens_details.cache_type string O tipo de cache. Consertado como ephemeral. Use.x_detalhes.put_tokens_detalhes objeto Classificação de notas de saída. Retornado para entrada multimodal. Mostrar atributos infantis Use.x_detalhes. output_tokens_detalhes. raciocinando_tokens inteiro O número de fichas de processo de raciocínio. Use.x_detalhes.put_tokens_details.text_tokens inteiro O número de fichas de texto. Retornado para entrada multimodal. Use.x_details.plugins objeto Estatísticas de chamadas de ferramentas. Retornado quando ferramentas incorporadas (como web_search) são usados, o mesmo que o nível superior x_tools Campo. Mostrar atributos infantis Use.x_details.plugins.web_search objeto Estatísticas de busca na internet. Mostrar atributos infantis Use.x_details.plugins.web_search.count inteiro O número de chamadas de busca na web nesta resposta. use.x_tools objeto Informações estatísticas sobre uso de ferramentas. Se ferramentas incorporadas são usadas, este campo inclui o número de chamadas para cada ferramenta. Exemplo: {"web_search": {"count": 1}}