Recupere uma resposta concluída do modelo pelo ID da resposta.
Substitua
O
Retornada quando o ID da resposta especificado não existe:
{WorkspaceId} pelo seu ID do workspace real.
China (Beijing)
O base_url para chamadas de SDK é: https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/compatible-mode/v1
URL da requisição HTTP: GET https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/compatible-mode/v1/responses/{response_id}
- China (Beijing)
O
base_url para chamadas de SDK é: https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/compatible-mode/v1URL da requisição HTTP: GET https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/compatible-mode/v1/responses/{response_id}Parâmetros de caminhoresponse_idstring(obrigatório)ID da resposta a recuperar. Formato: resp_xxx. Obtenha esse valor na resposta da API Criar resposta. Apenas IDs de resposta retornados com store=true na requisição de criação original podem ser recuperados. | Python |
RespostaRetorna o mesmo objeto Response da API Criar resposta. Os campos estão descritos abaixo: | |
id stringIdentificador exclusivo desta resposta, no formato resp_xxx. | |
object stringTipo do objeto. Sempre response. | |
status stringStatus da resposta. Valores possíveis: completed, failed, in_progress, cancelled, queued, incomplete. | |
created_at integerTimestamp Unix (em segundos) de criação da resposta. | |
completed_at integerTimestamp Unix (em segundos) em que a geração da resposta foi concluída. Retorna null se a resposta não estiver completa. | |
error objectObjeto de erro retornado quando o modelo falha ao gerar uma resposta. Retorna null em caso de sucesso. | |
model stringID do modelo usado para gerar a resposta. | |
output arrayItens de saída gerados pelo modelo. O tipo e a ordem dos elementos dependem da resposta do modelo.
Propriedades dos elementos do array type stringTipo do item de saída. Valores possíveis:
stringIdentificador exclusivo do item de saída. Presente em todos os tipos de saída.role stringFunção da mensagem. Sempre assistant. Presente apenas quando type for message.status stringStatus do item de saída. Valores possíveis: completed, in_progress. Presente quando type não for reasoning.name stringNome da ferramenta ou função. Presente quando type for function_call, web_search_image_call, image_search_call ou mcp_call.Para web_search_image_call e image_search_call, o valor é fixo como "web_search_image" e "image_search", respectivamente.Para mcp_call, o valor corresponde ao nome específico da função chamada no serviço MCP (por exemplo, amap-maps-maps_geo).arguments stringArgumentos da chamada de ferramenta, formatados como string JSON. Presente quando type for function_call, web_search_image_call, image_search_call ou mcp_call. Analise-o com JSON.parse() antes do uso. O conteúdo varia conforme o tipo de ferramenta:
stringIdentificador exclusivo da chamada de função. Presente apenas quando type for function_call. Use este ID para associar a requisição à resposta ao retornar resultados de chamadas de função.content arrayArray de conteúdo da mensagem. Presente apenas quando type for message.
Propriedades dos elementos do array type stringTipo de conteúdo. Sempre output_text.text stringConteúdo de texto gerado pelo modelo.annotations arrayAnotações de texto. Geralmente um array vazio.arrayResumos de raciocínio. Presente apenas quando type for reasoning. Cada elemento contém um campo type (valor summary_text) e um campo text (texto do resumo).action objectInformações da ação de busca. Presente apenas quando type for web_search_call.
Propriedades query stringPalavra-chave da consulta de busca.type stringTipo de busca. Sempre search.sources arrayFontes da busca. Cada elemento contém um campo type e um campo url.stringCódigo gerado e executado pelo modelo. Presente apenas quando type for code_interpreter_call.outputs arraySaídas da execução de código. Presente apenas quando type for code_interpreter_call. Cada elemento contém um campo type (valor logs) e um campo logs (logs de execução do código).container_id stringIdentificador do contêiner do interpretador de código. Presente apenas quando type for code_interpreter_call. Use-o para associar múltiplas execuções de código na mesma sessão.goal stringDescrição do objetivo de extração, especificando quais informações extrair da página da web. Presente apenas quando type for web_extractor_call.output stringResultado da chamada de ferramenta, formatado como string.
arrayURLs das páginas da web extraídas. Presente apenas quando type for web_extractor_call.server_label stringRótulo do serviço MCP. Presente apenas quando type for mcp_call. Identifica o serviço MCP usado nesta chamada.queries arrayConsultas usadas para recuperação na base de conhecimento. Presente apenas quando type for file_search_call. Cada elemento é uma consulta de busca gerada pelo modelo.results arrayResultados da recuperação da base de conhecimento. Presente apenas quando type for file_search_call.
Propriedades dos elementos do array file_id stringID do arquivo do documento correspondente.filename stringNome do arquivo do documento correspondente.score floatPontuação de relevância, variando de 0 a 1. Valores mais altos indicam maior relevância.text stringTrecho do conteúdo do documento correspondente. | |
usage objectInformações de uso de tokens para esta requisição.
Propriedades input_tokens integerNúmero de tokens de entrada.output_tokens integerNúmero de tokens de saída gerados pelo modelo.total_tokens integerTotal de tokens usados (input_tokens + output_tokens).input_tokens_details objectDetalhamento dos tokens de entrada.
Propriedades cached_tokens integerNúmero de tokens em cache.objectDetalhamento dos tokens de saída.
Propriedades reasoning_tokens integerNúmero de tokens de raciocínio.arrayDetalhes de faturamento.
Propriedades input_tokens integerTokens de entrada para este tipo de faturamento.output_tokens integerTokens de saída para este tipo de faturamento.total_tokens integerTotal de tokens para este tipo de faturamento.x_billing_type stringSempre response_api.prompt_tokens_details objectRetornado quando o cache de sessão está ativado. Contém um campo cached_tokens (número de tokens em cache).objectEstatísticas de uso de ferramentas. Quando ferramentas integradas são utilizadas, este campo contém a contagem de chamadas para cada ferramenta. Exemplo: {"web_search": {"count": 1}} | |
tools arrayReflete o parâmetro tools da requisição de criação. A estrutura corresponde ao parâmetro tools no corpo da requisição. Array vazio [] se nenhuma ferramenta tiver sido usada. | |
tool_choice stringReflete o parâmetro tool_choice da requisição de criação. Valores possíveis: auto, none, required. | |
parallel_tool_calls booleanReflete o parâmetro parallel_tool_calls da requisição de criação. Indica se o modelo pode chamar múltiplas ferramentas em paralelo. | |
temperature floatReflete o parâmetro temperature da requisição de criação. Controla a diversidade da saída do modelo. Faixa válida: [0, 2). Retorna o padrão do modelo se não definido. | |
top_p floatReflete o parâmetro top_p da requisição de criação. Limiar de probabilidade para amostragem de núcleo. Faixa válida: (0, 1,0]. Retorna o padrão do modelo se não definido. | |
frequency_penalty floatReflete o parâmetro frequency_penalty da requisição de criação. Valores positivos reduzem a probabilidade de repetição de palavras. | |
presence_penalty floatReflete o parâmetro presence_penalty da requisição de criação. Valores positivos aumentam a probabilidade de introdução de novos tópicos. | |
top_logprobs integerReflete o parâmetro top_logprobs da requisição de criação. Número de tokens mais prováveis retornados em cada posição. 0 se não habilitado. | |
store booleanReflete o parâmetro store da requisição de criação. true significa que a resposta é armazenada e referenciável por previous_response_id. false indica que ela não é armazenada. | |
service_tier stringNível de serviço. Sempre default. | |
background booleanIndica se a resposta foi executada de forma assíncrona. O Model Studio atualmente suporta apenas chamadas síncronas, portanto, este valor é sempre false. | |
metadata objectReflete o parâmetro metadata da requisição de criação. Pares chave-valor personalizados anexados à resposta. Objeto vazio {} se não definido. |