Pular para o conteúdo principal
GET
/
api
/
v1
/
llm
/
responses
/
{response_id}
/
input_items
Python (SDK)
from openapi import SDK


with SDK(
    bearer_auth="<YOUR_BEARER_TOKEN_HERE>",
) as sdk:

    res = sdk.llm.responses.list_input_items(response_id="resp_abc123", after="item_abc123", include=[
        "file_search_call.results",
    ], limit=50, order="asc")

    # Handle response
    print(res)
{
  "object": "list",
  "data": [
    {
      "type": "message",
      "id": "msg_user_abc123",
      "role": "user",
      "content": "What is the capital of France?"
    }
  ],
  "first_id": "msg_user_abc123",
  "last_id": "msg_user_abc123",
  "has_more": false
}

Autorizações

​
Authorization
string
header
obrigatório

Gateway auth: send Authorization: Bearer <mka1-api-key>. For multi-user server-side integrations, you can also send X-On-Behalf-Of: <external-user-id>.

Parâmetros de caminho

​
response_id
string
obrigatório

O identificador único da resposta, formatado como 'resp_' ou 'resp-' seguido por caracteres alfanuméricos.

Pattern: ^resp[-_][a-zA-Z0-9]+$

Parâmetros de consulta

​
after
string

Um ID de item a ser usado como um cursor para paginação. Retorna itens que vêm após este ID na lista. Usado para paginação baseada em cursor para buscar páginas subsequentes.

Exemplo:

"item_abc123"

​
include
enum<string>[]

Campos adicionais a serem incluídos nos itens de entrada. Permite solicitar dados aninhados específicos, como fontes de pesquisa na web, saídas do interpretador de código, capturas de tela do computador, resultados de busca de arquivos, imagens de entrada, logprobs de saída ou conteúdo de raciocínio. Esses campos podem ter implicações de desempenho ou custo.

Opções disponíveis:
web_search_call.action.sources,
code_interpreter_call.outputs,
computer_call_output.output.image_url,
file_search_call.results,
message.input_image.image_url,
message.output_text.logprobs,
reasoning.encrypted_content
Exemplo:
["file_search_call.results"]
​
limit
integer
padrão:20

O número máximo de itens de entrada a serem retornados por página. Deve ser entre 1 e 100. O padrão é 20 itens.

Intervalo obrigatório: 1 <= x <= 100
Exemplo:

50

​
order
enum<string>

A ordem para retornar os itens de entrada. 'asc' retorna os itens mais antigos primeiro, 'desc' retorna os itens mais novos primeiro. O padrão é 'desc' (mais novos primeiro).

Opções disponíveis:
asc,
desc
Exemplo:

"asc"

Resposta

200 - application/json

Lista paginada de itens de entrada para a resposta especificada.

Objeto de lista paginada contendo itens de entrada para uma resposta com metadados de paginação baseada em cursor.

​
object
any
obrigatório

O tipo de objeto, sempre 'lista' para respostas de lista paginadas.

​
data
(Input message item · object | Output message item · object | Output audio item · object | File search call item · object | Computer call item · object | Computer call output item · object | Web search call item · object | Function call item · object | Function call output item · object | Reasoning item · object | Image generation call item · object | Code interpreter call item · object | Local shell call item · object | Local shell call output item · object | Shell call item · object | Shell call output item · object | MCP list tools item · object | MCP approval request item · object | MCP approval response item · object | MCP call item · object | Custom tool call item · object | Custom tool call output item · object | Item reference item · object | Compaction item · object)[]
obrigatório

Array de itens de entrada (mensagens, solicitações, instruções) que foram fornecidos ao criar a resposta. Cada item contém seu tipo, conteúdo, função e metadados.

Mensagem de entrada: Uma mensagem com função e conteúdo. Use isso para turnos de usuário, assistente, sistema ou desenvolvedor em entradas estruturadas.

​
has_more
boolean
obrigatório

Indica se há mais itens disponíveis além da página atual. Verdadeiro se páginas adicionais existem, falso caso contrário.

​
first_id
string

O ID do primeiro item na página atual. Usado como ponto de referência para paginação.

​
last_id
string

O ID do último item na página atual. Usado como um cursor para buscar a próxima página.