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

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

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. Se utiliza para la paginación basada en cursor para obtener páginas posteriores.

Ejemplo:

"item_abc123"

include
enum<string>[]

Campos adicionales para incluir en los elementos de entrada. Permite solicitar datos específicos anidados como fuentes de búsqueda web, resultados de intérpretes de código, capturas de pantalla de computadoras, resultados de búsqueda de archivos, imágenes de entrada, probabilidades de salida o contenido de razonamiento. Estos campos pueden tener implicaciones en el rendimiento o en los costos.

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 recientes primero. Por defecto es 'desc' (más recientes 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 de 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 en caso contrario.

first_id
string

La ID del primer artículo 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.