Pular para o conteúdo principal
GET
/
api
/
v1
/
llm
/
responses
/
{response_id}
/
input_items
Python (SDK)
from mka1 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
}

Documentation Index

Fetch the complete documentation index at: https://docs.mka1.com/llms.txt

Use this file to discover all available pages before exploring further.

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>.

Cabeçalhos

​
X-On-Behalf-Of
string

Optional external end-user identifier forwarded by the API gateway.

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 para usar como um cursor para paginação. Retorna itens que vêm depois desse ID na lista. Usado para paginação baseada em cursor para buscar páginas subsequentes.

Exemplo:

"item_abc123"

​
include
enum<string>[]

Campos adicionais para incluir nos itens de entrada. Permite solicitar dados aninhados específicos, como fontes de pesquisa na web, saídas do intérprete de código, capturas de tela do computador, resultados de busca de arquivos, imagens de entrada, logprobs de saída ou conteúdos 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 ser retornado 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 paginada.

​
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.

Item de mensagem de entrada: Uma mensagem com papel 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 existirem, falso caso contrário.

​
first_id
string

O ID do primeiro item na página atual. Usado como um 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.