Saltar al contenido principal
GET
/
api
/
v1
/
llm
/
responses
Python (SDK)
from mka1 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
}

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 consulta

after
string

Un ID de respuesta para usar como un cursor para la paginación. Devuelve respuestas 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:

"resp_abc123"

before
string

Un ID de respuesta para usar como un cursor para la paginación. Devuelve las respuestas que vienen antes de este ID en la lista. Se utiliza para la paginación basada en cursores 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 es de 20 elementos.

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

25

order
enum<string>
predeterminado:desc

El pedido de 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 en caso contrario.

first_id
string

El ID de la primera respuesta en la página actual. Se utiliza como un 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.