Saltar al contenido 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.

Autorizaciones

​
Authorization
string
header
requerido

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

Encabezados

​
X-On-Behalf-Of
string

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

Parámetros de ruta

​
response_id
string
requerido

El identificador único de la respuesta, formateado como 'resp_' o 'resp-' seguido de caracteres alfanuméricos.

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

Parámetros de consulta

​
after
string

Un ID de artículo para usar como un cursor para la paginación. Devuelve los artículos que vienen después de este ID en la lista. Utilizado para la paginación basada en cursor para obtener páginas subsecuentes.

Ejemplo:

"item_abc123"

​
include
enum<string>[]

Campos adicionales para incluir en los elementos de entrada. Permite solicitar datos anidados específicos como fuentes de búsqueda web, salidas del intérprete de código, capturas de pantalla de la computadora, resultados de búsqueda de archivos, imágenes de entrada, logprobs de salida o contenido de razonamiento. Estos campos pueden tener implicaciones de rendimiento o costo.

Opciones disponibles:
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
Ejemplo:
["file_search_call.results"]
​
limit
integer
predeterminado:20

El número máximo de elementos de entrada a devolver por página. Debe estar entre 1 y 100. Por defecto, son 20 elementos.

Rango requerido: 1 <= x <= 100
Ejemplo:

50

​
order
enum<string>

El orden para devolver los elementos de entrada. 'asc' devuelve los elementos más antiguos primero, 'desc' devuelve los elementos más nuevos primero. Por defecto es 'desc' (más nuevos primero).

Opciones disponibles:
asc,
desc
Ejemplo:

"asc"

Respuesta

200 - application/json

Lista paginada de elementos de entrada para la respuesta especificada.

Objeto de lista paginada que contiene elementos de entrada para una respuesta con metadatos de paginación basada en cursor.

​
object
any
requerido

El tipo de objeto, siempre 'lista' para respuestas de listas 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)[]
requerido

Array de elementos de entrada (mensajes, indicaciones, instrucciones) que se proporcionaron al crear la respuesta. Cada elemento contiene su tipo, contenido, rol y metadatos.

Elemento del mensaje de entrada: Un mensaje con rol y contenido. Utiliza esto para turnos de usuario, asistente, sistema o desarrollador en entradas estructuradas.

​
has_more
boolean
requerido

Indica si hay más elementos disponibles más allá de la página actual. Verdadero si existen páginas adicionales, falso de lo contrario.

​
first_id
string

La ID del primer elemento en la página actual. Se utiliza como un punto de referencia para la paginación.

​
last_id
string

El ID del último elemento en la página actual. Se utiliza como un cursor para obtener la siguiente página.