Saltar al contenido principal
GET
/
api
/
v1
/
llm
/
responses
Python (SDK)
from openapi import SDK


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

    res = sdk.llm.responses.list(after="resp_abc123", before="resp_xyz789", limit=25, order="desc")

    # Handle response
    print(res)
{
  "object": "list",
  "data": [
    {
      "id": "resp_abc123",
      "object": "response",
      "created_at": 1735689600,
      "completed_at": 1735689601,
      "status": "completed",
      "error": null,
      "incomplete_details": null,
      "background": false,
      "instructions": null,
      "max_output_tokens": null,
      "max_tool_calls": 30,
      "metadata": {
        "status": "reviewed",
        "reviewer": "john_doe"
      },
      "model": "meetkai:functionary-urdu-mini-pak",
      "output": [
        {
          "type": "message",
          "id": "msg_abc123",
          "role": "assistant",
          "content": [
            {
              "type": "output_text",
              "text": "The capital of France is Paris.",
              "annotations": []
            }
          ],
          "status": "completed"
        }
      ],
      "output_text": "The capital of France is Paris.",
      "parallel_tool_calls": true,
      "previous_response_id": null,
      "reasoning": {
        "effort": null,
        "summary": null
      },
      "service_tier": "auto",
      "store": true,
      "text": {
        "format": {
          "type": "text"
        },
        "verbosity": "medium"
      },
      "tool_choice": "auto",
      "tools": [],
      "truncation": "auto",
      "usage": {
        "input_tokens": 8,
        "input_tokens_details": {
          "cached_tokens": 0
        },
        "output_tokens": 7,
        "output_tokens_details": {
          "reasoning_tokens": 0
        },
        "total_tokens": 15
      },
      "user": null
    }
  ],
  "first_id": "resp_abc123",
  "last_id": "resp_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 consulta

after
string

Un ID de respuesta para usar como un cursor para la paginación. Devuelve las respuestas que vienen después de este ID en la lista. Utilizado para la paginación basada en cursos para obtener páginas subsiguientes.

Ejemplo:

"resp_abc123"

before
string

Un ID de respuesta para usar como un cursor para la paginación. Devuelve las respuestas que están antes de este ID en la lista. Se usa para la paginación basada en cursor para obtener páginas anteriores.

Ejemplo:

"resp_xyz789"

limit
integer
predeterminado:20

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

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

25

order
enum<string>
predeterminado:desc

La orden para devolver las respuestas por fecha de creación. 'asc' devuelve las respuestas más antiguas primero, 'desc' devuelve las respuestas más recientes primero. Por defecto es 'desc' (más recientes primero).

Opciones disponibles:
asc,
desc
Ejemplo:

"desc"

Respuesta

200 - application/json

Lista paginada de respuestas para el usuario autenticado.

Objeto de lista paginada que contiene respuestas con metadatos de paginación basados en cursor.

object
any
requerido

El tipo de objeto, siempre 'lista' para respuestas de listas paginadas.

data
object[]
requerido

Array de objetos de respuesta. Cada respuesta contiene su estado, modelo, entrada/salida, registros de uso de herramientas, metadatos e información de finalización.

has_more
boolean
requerido

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

first_id
string

La ID de la primera respuesta en la página actual. Se utiliza como punto de referencia para la paginación.

last_id
string

El ID de la última respuesta en la página actual. Se utiliza como un cursor para obtener la siguiente página.