Utilize a Responses API compatível com OpenAI para chamar o modelo Qwen. Este tópico descreve os parâmetros de entrada e saída e fornece um exemplo de chamada.
- Ferramentas integradas: Obtenha melhores resultados em tarefas complexas com ferramentas nativas como busca na web, scraping da web, interpretador de código, texto para imagem, imagem para imagem e busca em base de conhecimento. Para mais informações, consulte tool calling.
- Entrada mais flexível: Aceita tanto strings diretas quanto arrays de mensagens no formato de chat.
- Gerenciamento simplificado de contexto: Evite construir manualmente um array de histórico de mensagens passando o
previous_response_idda última resposta. - Cache de contexto prático: Adicione
x-dashscope-session-cache: enable(valor padrão: disable) ao cabeçalho da requisição para ativar o cache automático do contexto de conversa no lado do servidor. Isso reduz a latência de inferência e os custos em conversas de múltiplas rodadas sem exigir alterações no código. Para detalhes, consulte session cache.
Compatibilidade e limitações
Esta API é compatível com a OpenAI para reduzir o custo de migração dos desenvolvedores, mas difere em seus parâmetros, funcionalidades e comportamento.
Princípio fundamental: Apenas os parâmetros listados explicitamente neste documento são processados. Quaisquer parâmetros da OpenAI não mencionados serão ignorados.
As principais diferenças abaixo ajudarão você a se adaptar rapidamente:
- Parâmetros não suportados: Esta API não aceita alguns parâmetros da API OpenAI, como o parâmetro de execução assíncrona
background. Atualmente, apenas chamadas síncronas são suportadas. - Controle do esforço de raciocínio: Utilize o parâmetro
reasoning.effortpara controlar o nível de raciocínio do modelo. Para detalhes de uso, consulte a descrição deste parâmetro.
- Singapore
- China (Beijing)
- US (Virginia)
- Germany (Frankfurt)
- China (Hong Kong)
- Japan (Tokyo)
base_url como https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1.Endpoint da requisição HTTP: POST https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1/responses{WorkspaceId} pelo seu workspace ID real.
Corpo da requisição |
Python |
model string (obrigatório)O ID do modelo a ser utilizado.
Modelos suportados qwen3.8-max, qwen3.8-flash, qwen3.7-max, qwen3.7-max-2026-05-20, qwen3.7-max-2026-06-08, qwen3.7-max-2026-05-17, qwen3.7-max-preview, qwen3-max, qwen3-max-2026-01-23, qwen3.7-plus, qwen3.7-plus-2026-05-26, qwen3.6-plus, qwen3.6-plus-2026-04-02, qwen3.5-plus, qwen3.5-plus-2026-04-20, qwen3.5-plus-2026-02-15, qwen3.7-flash, qwen3.7-flash-2026-07-15, qwen3.6-flash, qwen3.6-flash-2026-04-16, qwen3.5-flash, qwen3.5-flash-2026-02-23, qwen3.8-2.4t-a95b, qwen3.8-27b, qwen3.6-35b-a3b, qwen3.5-397b-a17b, qwen3.5-122b-a10b, qwen3.5-27b, qwen3.5-35b-a3b, deepseek-v4-pro, deepseek-v4-pro-0813, deepseek-v4-flash, deepseek-v4-flash-0731, glm-5.2, kimi-k3 |
input string ou array (obrigatório)A entrada para o modelo. Os seguintes formatos são suportados:
Tipos de itens do array EasyInputMessage objectUm objeto com um role para o autor da mensagem e content para o conteúdo da mensagem.
Propriedades role string (obrigatório)A função do autor da mensagem. Valores válidos: user, assistant, system, developer.content string ou array (obrigatório)O conteúdo da mensagem. O conteúdo é uma string se a entrada for texto simples, ou um array se a entrada for um array de conteúdo estruturado. Quando o role é system ou developer, o tipo de elemento do array é input_text. Quando o role é user, o tipo de elemento do array é input_text, input_image ou input_file. Quando o role é assistant, o tipo de elemento do array é output_text.A API Responses não suporta atualmente entrada de vídeo ou áudio. Para passar esses tipos de dados, use Chat Completions API ou DashScope API.
Itens do array de conteúdo type string (obrigatório)Especifica o tipo de conteúdo. Os valores válidos são input_text, input_image (apenas função user), input_file (apenas função user, suporta PDF e imagens) e output_text (apenas função assistant).text stringO conteúdo de texto. Obrigatório quando type é input_text ou output_text.image_url stringSuporta uma URL ou dados codificados em Base64. Obrigatório quando type é input_image. Para Base64, forneça um Data URI completo, por exemplo: data:image/png;base64,iVBORw0KGgoAAAANSUhEUg....file_url stringA URL pública do arquivo. Obrigatória quando type é input_file. Suporta arquivos PDF (até 100 MB) e arquivos de imagem (até 20 MB). Atualmente suportado apenas por qwen3.5-ocr.O limite de páginas do PDF depende de task em ocr_options: até 50 páginas quando task é definido como document_parsing; até 10 páginas quando task não é definido ou é definido como outra tarefa.string (opcional)Fixo como message.object (opcional)A mensagem de saída do modelo. Para continuar uma conversa, passe o objeto message do array output de uma resposta anterior de volta para o input. Diferente de EasyInputMessage, este objeto inclui a estrutura completa de saída, com id, status e content estruturado.
Propriedades type string (obrigatório)Fixo como message.id string (obrigatório)O identificador exclusivo da mensagem de saída, proveniente da resposta anterior.role string (obrigatório)Fixo como assistant.status string (obrigatório)O status da mensagem. Valores válidos: in_progress, completed, incomplete.content array (obrigatório)Um array de conteúdo, onde os elementos são objetos output_text.
Propriedades type string (obrigatório)Fixo como output_text.text string (obrigatório)O texto da resposta.annotations array (opcional)Informações de anotação.object (opcional)Uma instrução estruturada gerada quando o modelo decide chamar uma ferramenta externa.
Propriedades type string (obrigatório)Fixo como function_call.id string (opcional)O identificador exclusivo para a chamada de função, proveniente da resposta anterior.name string (obrigatório)O nome da função da ferramenta.arguments string (obrigatório)Os argumentos da chamada de ferramenta, no formato de string JSON.call_id string (obrigatório)O identificador para a chamada de ferramenta. Este deve corresponder ao call_id retornado pelo modelo.status string (opcional)O status. Valores válidos: in_progress, completed, incomplete.object (opcional)A saída de uma chamada de ferramenta. Na lista de mensagens, este objeto deve seguir imediatamente sua mensagem function_call correspondente para evitar falha na solicitação.
Propriedades type string (obrigatório)Fixo como function_call_output.id string (opcional)O identificador exclusivo para a saída da chamada de função.call_id string (obrigatório)O identificador da chamada de ferramenta deve corresponder ao call_id retornado pelo modelo.output string (obrigatório)O resultado da execução da função da ferramenta.status string (opcional)O status. Valores válidos: in_progress, completed, incomplete.object (opcional)O processo de raciocínio do modelo. Passe o item reasoning do output de uma resposta anterior de volta para o input para continuar esse processo em um turno subsequente.
Propriedades type string (obrigatório)Fixo como reasoning.id string (obrigatório)O identificador exclusivo para o conteúdo de raciocínio, proveniente da resposta anterior.summary array (obrigatório)O conteúdo do resumo de raciocínio.
Propriedades type string (obrigatório)Fixo como summary_text.text string (obrigatório)O texto do resumo.string (opcional)O status. Valores válidos: in_progress, completed, incomplete.object (opcional)Um objeto de chamada de pesquisa na web. Passe o item web_search_call da saída da resposta anterior de volta para a entrada, fornecendo contexto de resultados de pesquisa em conversas de múltiplos turnos.
Propriedades type string (obrigatório)Sempre web_search_call.id string (obrigatório)O identificador exclusivo da chamada de pesquisa, proveniente da resposta anterior.status string (obrigatório)O status da pesquisa. Valores válidos: in_progress, searching, completed, failed.action object (obrigatório)Os detalhes da ação de pesquisa. Apenas o tipo search é suportado.
Propriedades type string (obrigatório)O tipo de pesquisa. Sempre search.queries array (opcional)Uma lista de consultas de pesquisa. Cada elemento é uma string.sources array (opcional)Uma lista de fontes de resultados de pesquisa.
Propriedades type string (obrigatório)O tipo de fonte. Sempre url.url string (obrigatório)A URL da fonte. |
instructionsstring (opcional)Inserido no início do contexto como uma instrução do sistema. Quando previous_response_id é utilizado, as instructions especificadas no turno anterior não são passadas para o contexto do turno atual. |
previous_response_id string (opcional)O ID exclusivo da resposta anterior. O id de uma resposta é válido por 7 dias. Use este parâmetro para criar conversas de múltiplos turnos. O servidor recupera e combina automaticamente a entrada e a saída desse turno como contexto. Se você fornecer tanto o array de mensagens de input quanto o previous_response_id, as novas mensagens no input serão anexadas ao contexto histórico. Este parâmetro não pode ser usado com conversation. |
conversation string (opcional)A conversa à qual a resposta atual pertence (consulte Conversations API). O histórico da conversa é incluído automaticamente como contexto. A entrada e a saída desta solicitação são adicionadas à conversa após a conclusão. Não pode ser usado com previous_response_id. |
stream boolean (opcional) O padrão é falseAtiva a saída em stream. Se definido como true, o modelo transmite a resposta em tempo real. |
store boolean (opcional) O padrão é trueEspecifica se a resposta do modelo gerada para esta sessão deve ser armazenada.
|
tools array (opcional)Um array de ferramentas que o modelo pode chamar ao gerar uma resposta. Há suporte tanto para ferramentas integradas quanto para ferramentas personalizadas do tipo function, que podem ser usadas em conjunto.Para obter os melhores resultados, ative as ferramentas
Propriedades Pesquisa na webPesquisa informações atualizadas na internet. Documentação relacionada: Web Search
Propriedades type string (obrigatório)Valor fixo: web_search.Exemplo: [{"type": "web_search"}]web_search. Para os modelos qwen3-max e qwen3-max-2026-01-23, também é necessário ativar o modo de raciocínio. Documentação relacionada: Web Extraction
Propriedades type string (obrigatório)Valor fixo: web_extractor.Exemplo: [{"type": "web_search"}, {"type": "web_extractor"}]qwen3-max e qwen3-max-2026-01-23, o modo de raciocínio também precisa estar ativado. Documentação relacionada: Code Interpreter
Propriedades type string (obrigatório)Valor fixo: code_interpreter.Exemplo: [{"type": "code_interpreter"}]
Propriedades type string (obrigatório)Valor fixo: web_search_image.Exemplo: [{"type": "web_search_image"}]
Propriedades type string (obrigatório)Valor fixo: image_search.Exemplo: [{"type": "image_search"}]
Propriedades type string (obrigatório)Valor fixo: file_search.vector_store_ids array(obrigatório)O ID da base de conhecimento a ser pesquisada. No momento, apenas um ID de base de conhecimento pode ser fornecido.Exemplo: [{"type": "file_search", "vector_store_ids": ["your_knowledge_base_id"]}]
Propriedades type string (obrigatório)Valor fixo: mcp.server_protocol string (obrigatório)O protocolo de comunicação com o service MCP, como "sse".server_label string (obrigatório)Um rótulo usado para identificar o service MCP.server_description string (opcional)Uma descrição do service. Ajuda o modelo a entender sua função e quando utilizá-lo.server_url string (obrigatório)A URL do endpoint do service MCP.headers object (opcional)Cabeçalhos da requisição, usados para transmitir informações como autenticação (por exemplo, Authorization).Exemplo:function_call. Documentação relacionada: Function calling
Propriedades type string (obrigatório)Deve ser definido como function.namestring(obrigatório)O nome da ferramenta. Pode conter apenas letras, dígitos, sublinhados (_) e hifens (-), com comprimento máximo de 64 tokens.descriptionstring(obrigatório)Uma descrição da ferramenta, que ajuda o modelo a decidir quando e como chamá-la.parameters object (opcional)A definição de parâmetros da ferramenta, que deve ser um objeto JSON Schema válido. Se parameters estiver vazio, a ferramenta não aceita argumentos (por exemplo, uma ferramenta de consulta de hora).
Para melhorar a precisão das chamadas de ferramentas, recomendamos definir Exemplo: |
tool_choice string ou object (opcional) O padrão é autoControla como o modelo seleciona e chama as ferramentas. Este parâmetro aceita dois formatos: modo string e modo object.Modo string
Propriedades mode string (obrigatório)
array(obrigatório)Uma lista de definições de ferramentas que o modelo tem permissão para chamar.string (obrigatório)O tipo de configuração da ferramenta. Valor fixo: allowed_tools. |
temperaturefloat(opcional)A temperatura de amostragem, que controla a diversidade do texto gerado.Valores mais altos tornam a saída mais aleatória e diversificada, enquanto valores mais baixos a tornam mais focada e determinística.Intervalo de valores: [0, 2)Tanto temperature quanto top_p controlam a diversidade do texto gerado. Recomendamos usar apenas um desses parâmetros por vez. Para mais informações, consulte Overview. |
top_pfloat(opcional)O limiar de probabilidade para amostragem top-p, que controla a diversidade do texto gerado.Valores mais altos tornam a saída mais aleatória e diversificada, enquanto valores mais baixos a tornam mais focada e determinística.Intervalo de valores: (0, 1.0]Tanto temperature quanto top_p controlam a diversidade do texto gerado. Recomendamos usar apenas um desses parâmetros por vez. Para mais informações, consulte Overview. |
enable_thinking boolean (opcional)Ativa ou desativa o modo de raciocínio. Quando ativado, o modelo executa uma etapa de raciocínio antes de responder. O processo de raciocínio é retornado como um item de saída do tipo reasoning. Ao ativar o modo de raciocínio, recomendamos também habilitar as ferramentas integradas para obter os melhores resultados em tarefas complexas.Valores válidos:
Este parâmetro não é um parâmetro padrão da OpenAI. No SDK Python, passe-o usando |
reasoning object (opcional)Controla o esforço de raciocínio do modelo. O modelo executa uma etapa de raciocínio antes de responder, e o processo de raciocínio é retornado por meio de um item de saída do tipo reasoning.
Propriedades effort string (opcional): O nível de esforço de raciocínio. O padrão é xhigh.Aceita 7 níveis incrementais: none, minimal, low, medium, high, xhigh e max. Reduzir este valor acelera a velocidade de resposta e diminui o consumo de tokens de inferência.Os níveis
|
ocr_options object (opcional)Parâmetros de tarefas integradas de OCR. Aplicável apenas ao modelo qwen3.5-ocr. Use este parâmetro para chamar tarefas integradas de OCR (como extração de informações e localização de texto). Os resultados das tarefas integradas são retornados no campo ocr_result da resposta.Ao analisar arquivos PDF, o valor de task determina o número de páginas suportadas: até 50 páginas quando definido como document_parsing; até 10 páginas quando task não é definido ou é definido como outra tarefa.Este parâmetro não é um parâmetro padrão da OpenAI. No SDK Python, passe-o usando |
max_output_tokens integer (opcional)
incomplete. |
Objeto de resposta (saída sem streaming) | |
id stringIdentificador único desta resposta, no formato UUID. Este ID permanece válido por 7 dias e pode ser utilizado no parâmetro previous_response_id para criar uma conversa com múltiplas turnos. | |
created_at integerTimestamp Unix (em segundos) desta solicitação. | |
object stringTipo do objeto, sempre definido como response. | |
status stringStatus da geração da resposta. Valores válidos:
| |
model stringID do modelo utilizado para gerar a resposta. | |
output arrayArray de itens 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 válidos:
stringIdentificador único do item de saída. Todos os tipos de itens de saída contêm este campo.role stringA função da mensagem é sempre assistant. Este parâmetro está presente apenas quando type é message.status stringStatus do item de saída. Valores válidos: completed e in_progress. Este parâmetro está presente quando o parâmetro type não está definido como reasoning.name stringNome da ferramenta ou função. Este parâmetro está presente quando type é function_call, web_search_image_call, image_search_call ou mcp_call.Para web_search_image_call e image_search_call, os valores são fixos como "web_search_image" e "image_search", respectivamente.Para mcp_call, o valor corresponde ao nome da função específica chamada no service MCP, como amap-maps-maps_geo.arguments stringParâmetros da chamada de ferramenta, em formato de string JSON. Este parâmetro está presente quando type é function_call, web_search_image_call, image_search_call ou mcp_call. Faça o parse da string utilizando JSON.parse() antes de usar. O conteúdo dos argumentos para os diferentes tipos de ferramentas é o seguinte:
stringID único da chamada de função. Este parâmetro é incluído apenas quando type é function_call. É obrigatório incluir este ID no resultado da chamada de função para vincular a solicitação à resposta.content arrayArray com o conteúdo da mensagem. Este parâmetro está presente apenas se type estiver definido como message.
Propriedades dos elementos do array type stringTipo de conteúdo. O valor é fixo como output_text.text stringContúdo de texto gerado pelo modelo.annotations arrayArray de anotações de texto. Geralmente é um array vazio.arrayArray de resumos de raciocínio. Este campo está presente apenas quando type é reasoning. Cada elemento contém o campo type (valor: summary_text) e o campo text (o texto do resumo).action objectInformações sobre a ação de pesquisa. Este parâmetro está presente apenas quando type é web_search_call.
Propriedades query stringPalavras-chave da consulta de pesquisa.type stringTipo de pesquisa. O valor é sempre search.sources arrayLista de fontes de pesquisa. Cada elemento contém os campos type e url.stringCódigo gerado e executado pelo modelo. Existe apenas quando type é code_interpreter_call.outputs arrayArray de saída da execução de código. Presente apenas quando type é code_interpreter_call. Cada elemento possui um campo type (com valor logs) e um campo logs (os logs de execução do código).container_id stringIdentificador do container do interpretador de código. Este parâmetro está presente apenas quando type é code_interpreter_call. Este identificador associa múltiplas execuções de código dentro da mesma sessão.goal stringDescrição das informações a serem extraídas da página web. Disponível apenas quando type é web_extractor_call.output stringSaída da chamada de ferramenta. A saída é uma string.
arrayLista de URLs das páginas web extraídas. Disponível apenas quando type é web_extractor_call.server_label stringRótulo do service MCP. Aparece apenas quando type é mcp_call. Indica qual service MCP foi utilizado na chamada.queries arrayLista de consultas para recuperação na base de conhecimento. Existe apenas quando type é file_search_call. O array contém strings, sendo cada uma delas uma consulta de pesquisa gerada pelo modelo.results arrayArray de resultados de pesquisa da base de conhecimento. Presente apenas quando type é 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 da correspondência. O valor varia de 0 a 1. Um valor maior indica maior relevância.text stringTrecho de conteúdo do documento correspondente. | |
usage objectInformações sobre o consumo de tokens nesta solicitação.
Propriedades input_tokens integerNúmero de tokens na entrada. Additional Notesoutput_tokens integerQuantidade de tokens na saída do modelo.total_tokens integerTotal de tokens consumidos, correspondente à soma de input_tokens e output_tokens.input_tokens_details objectClassificação detalhada dos tokens de entrada.
Propriedades cached_tokens integerNúmero de tokens que atingiram o cache. Para mais informações, consulte context caching.objectDetalhamento dos tokens de saída.
Propriedades reasoning_tokens integerQuantidade de tokens de raciocínio.arrayArray com detalhes de faturamento da solicitação. Fornece um detalhamento mais granular dos tokens multimodais do que o campo usage de nível superior.
Propriedades input_tokens integerNúmero de tokens na entrada. Additional Notesoutput_tokens integerQuantidade de tokens na saída do modelo.total_tokens integerTotal de tokens consumidos, correspondente à soma de input_tokens e output_tokens.x_billing_type stringValor fixo definido como response_api.image_tokens integerNúmero de tokens para entrada de imagem. Este campo é retornado quando a entrada inclui uma imagem e equivale a input_tokens_details.image_tokens.input_tokens_details objectDetalhamento granular dos tokens de entrada. Retornado para entradas multimodais. Atualmente distingue apenas entre text_tokens e image_tokens. Não fornece detalhamento para tokens de vídeo ou áudio.
Propriedades text_tokens integerQuantidade de tokens para entrada de texto.image_tokens integerNúmero de tokens para entrada de imagem.objectDetalhamento granular dos tokens de saída. Este campo possui um campo adicional text_tokens em comparação com o output_tokens_details de nível superior. O campo text_tokens é retornado para entradas multimodais.
Propriedades reasoning_tokens integerQuantidade de tokens utilizados no processo de raciocínio.text_tokens integerNúmero de tokens para saída de texto. Retornado para entradas multimodais.objectEstatísticas de chamadas de ferramentas integradas. Retornado quando uma ferramenta integrada como web_search é utilizada. Seu conteúdo é idêntico ao campo x_tools de nível superior.
Propriedades web_search objectEstatísticas das chamadas de pesquisa web.
Propriedades count integerNúmero de vezes que a pesquisa web foi chamada nesta resposta.objectDetalhes de cache para tokens de entrada. Retornado quando o cache de sessão está ativado. Pode retornar um objeto vazio se a entrada incluir uma imagem, mas resultar em cache miss.
Propriedades cached_tokens integerQuantidade de tokens que atingiram o cache.cache_creation_input_tokens integerNúmero de tokens usados para criar um novo cache nesta solicitação.cache_creation objectDetalhes sobre a criação de cache.
Propriedades ephemeral_5m_input_tokens integerTokens utilizados para criar um novo cache efêmero de 5 minutos.stringTipo de cache. Valor fixo definido como ephemeral.objectEstatísticas de uso de ferramentas. Contém o número de chamadas de cada ferramenta integrada.Exemplo: {"web_search": {"count": 1}} | |
error objectUm objeto de erro é retornado quando o modelo falha ao gerar uma resposta. Caso contrário, o valor é null. | |
tools arrayReplica o conteúdo completo do parâmetro tools da solicitação, mantendo a mesma estrutura do parâmetro tools no corpo da requisição. | |
tool_choice stringRepete o valor do parâmetro tool_choice da solicitação. Os valores válidos são auto, none e required. |
Objeto de fragmento de resposta (saída em streaming) | |
A saída em streaming retorna uma série de objetos JSON. Cada objeto inclui um campo type para especificar o tipo de evento e um campo sequence_number para indicar a ordem dos eventos. O evento response.completed marca o fim do stream. | |
type stringIdentificador do tipo de evento. Os valores possíveis incluem:
| |
sequence_number integerNúmero de sequência do evento, começando em 0 e incrementando a cada evento. Utilize este número para processar os eventos na ordem correta. | |
response objectObjeto de resposta. Presente nos eventos response.created, response.in_progress e response.completed. No evento response.completed, ele contém os dados completos da resposta (incluindo output e usage), e sua estrutura é idêntica à do objeto Response não-streaming. | |
item objectObjeto de item de saída. Aparece nos eventos response.output_item.added e response.output_item.done. No evento added, trata-se de um esqueleto inicial onde o content é um array vazio. No evento done, é um objeto completo.
Propriedades id stringIdentificador exclusivo para o item de saída (por exemplo, msg_xxx).type stringTipo do item de saída. Valores possíveis: message, reasoning, web_search_call, web_search_image_call (busca de texto para imagem), image_search_call (busca de imagem para imagem), mcp_call (chamada MCP), file_search_call (busca em base de conhecimento).role stringFunção da mensagem, que é sempre assistant. Presente apenas quando type é message.status stringStatus de geração. Em um evento added, o status é in_progress; em um evento done, é completed.content arrayArray de conteúdo da mensagem. No evento added, o array está vazio []. No evento done, contém objetos completos de partes de conteúdo cuja estrutura é igual à do objeto part. | |
part objectObjeto de parte de conteúdo. Presente nos eventos response.content_part.added e response.content_part.done.
Propriedades type stringTipo da parte de conteúdo, que é sempre output_text.text stringConteúdo de texto. É uma string vazia no evento added e o texto completo no evento done.annotations arrayArray de anotações de texto. Geralmente é um array vazio.logprobs object | nullProbabilidades logarítmicas de tokens. Atualmente, este campo sempre retorna null. | |
delta stringSegmento de texto incremental. Este campo aparece no evento response.output_text.delta e contém o segmento de texto recém-adicionado. Concatene todos os valores de delta para reconstruir o texto completo. | |
text stringConteúdo de texto completo. Este campo aparece no evento response.output_text.done. Use-o para validar o texto reconstruído a partir dos fragmentos delta. | |
item_id stringIdentificador exclusivo do item de saída. Utilize este ID para correlacionar eventos pertencentes ao mesmo item. | |
output_index integerÍndice do item de saída no array output. | |
content_index integerÍndice da parte de conteúdo no array content. |
Perguntas frequentes
P: Como passar o contexto em uma conversa de múltiplas turnos?
R: Ao fazer uma nova solicitação de conversa, passe o id da resposta anterior bem-sucedida do modelo como o parâmetro previous_response_id.
P: Por que alguns campos no exemplo de resposta não estão descritos neste tópico?
R: O SDK oficial da OpenAI pode gerar campos adicionais definidos pelo protocolo da OpenAI. Nosso service não oferece suporte a esses campos, portanto, eles geralmente são null. Considere apenas os campos descritos neste tópico.