> ## 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. # Lista las ejecuciones de la clasificación para un conjunto de evaluación > Devuelve en una sola solicitud las ejecuciones completadas más recientes de cada grupo de clasificación para una suite, con las asignaciones de grupo en `groups`. Un grupo es (model, tarea objetivo) para ejecuciones restringidas por task_ids y (model) para ejecuciones no restringidas (task_id null). Construye los tableros a partir de `groups`, no de run.models/run.task_ids: una ejecución devuelta puede nombrar modelos o tareas en cuyos grupos no quedó clasificada. `truncated: true` significa que un límite del servidor recortó el agregado; las ejecuciones completas se conservan en el orden (mejor rango, primer modelo, primera tarea, id), de modo que las ejecuciones más recientes de cada grupo sobreviven antes que los respaldos de cualquier grupo y no se descarta ningún grupo por ser antiguo. Reanuda un tablero truncado pasando `next_cursor` de vuelta como `cursor` y uniendo las respuestas. Consulta la documentación de evals para conocer la justificación del agrupamiento y las características de coste. ## OpenAPI ````yaml https://apigw.mka1.com/speakeasy.json?language=es get /api/v1/llm/evals/suites/{suite_id}/leaderboard-runs openapi: 3.1.1 info: title: MKA1 API version: 1.1.0 description: >- La API MKA1 es una API RESTful que proporciona acceso a la plataforma MKA1. Aprende cómo comenzar con la API y el SDK de TypeScript [aquí](https://mka1.apidocumentation.com/guides/getting-started). license: name: Propietario servers: - url: https://apigw.mka1.com description: MKA1 API Gateway - url: / description: Relative server URL (configurable via SDK constructor) security: [] tags: - name: Resource Authorization description: >- Gestiona permisos para recursos LLM. Crea recursos, otorga/revoca permisos y elimina recursos. Solo los propietarios de recursos pueden otorgar, revocar o eliminar permisos. x-displayName: Autorización de Recursos - name: Embeddings description: >- Puntos finales de la API de incrustación de texto para generar representaciones vectoriales del texto. Crea incrustaciones semánticas para búsqueda, agrupamiento y coincidencia de similitudes utilizando varios modelos de incrustación. x-displayName: Incrustaciones - name: Feedback description: >- API de retroalimentación del usuario para calificar y comentar sobre las completaciones de chat. Recopila calificaciones de pulgares arriba/abajo y comentarios detallados para mejorar las respuestas del modelo y rastrear la satisfacción del usuario. x-displayName: Retroalimentación - name: Images description: >- Puntos finales de la API de generación de imágenes para crear imágenes a partir de descripciones de texto. Genera imágenes con control sobre el tamaño, la calidad y el estilo. x-displayName: Imágenes - name: MCP Vault description: >- API de bóveda MCP para almacenar configuraciones de servidor MCP propiedad del usuario y credenciales encriptadas. Los agentes hacen referencia a los ID de la bóveda para que los secretos se resuelvan solo en el momento de la ejecución de la herramienta. x-displayName: Bóveda MCP - name: Speech description: >- Puntos finales de la API de voz para el procesamiento de audio. Convierte texto en habla natural (TTS) o transcribe el habla a texto (STT) en diferentes idiomas. x-displayName: Discurso - name: Usage description: >- API de seguimiento de uso y análisis para monitorear el consumo de tokens, la cantidad de solicitudes y el análisis de costos. Visualiza estadísticas detalladas por usuario, modelo y período de tiempo. x-displayName: Uso - name: Extract description: >- API de extracción de datos estructurados para extraer información de archivos. Define esquemas JSON para extraer datos estructurados de imágenes, PDFs y documentos. Soporta plantillas de esquemas reutilizables. x-displayName: Extracción - name: Text Classification description: >- API de clasificación de texto para categorizar texto en etiquetas predefinidas. Utilice modelos de IA para clasificar el contenido del texto para análisis de sentimientos, categorización de temas y moderación de contenido. x-displayName: Clasificación de Texto - name: Responses description: >- API de respuestas impulsadas por agentes para crear agentes de IA con uso autónomo de herramientas. Crea asistentes conversacionales que pueden utilizar búsqueda en la web, operaciones con archivos, generación de imágenes, ejecución de código, simulación de uso de computadoras e integraciones de MCP. Soporta procesamiento en segundo plano, transmisión y seguimiento de estado en tiempo real. x-displayName: Respuestas - name: Files description: >- API de gestión de archivos para cargar, almacenar y gestionar archivos con expiración automática e integración con S3. Carga archivos que se pueden usar con Asistentes, Almacenes Vectoriales y otras funciones. Los archivos se almacenan en S3 con metadatos rastreados en PostgreSQL. Soporta la limpieza automática de archivos expirados. x-displayName: Archivos - name: Vector Stores description: >- API de almacenamiento de vectores para almacenar y buscar documentos utilizando incrustaciones. Crea almacenes de vectores, sube archivos con fragmentación automática y generación de incrustaciones, y realiza búsquedas semánticas. Los archivos se procesan de forma asincrónica utilizando flujos de trabajo de Temporal para durabilidad. Soporta limpieza automática de almacenes caducados y LanceDB para almacenamiento eficiente de vectores. x-displayName: Almacenes de Vectores - name: Conversations description: >- API de gestión de conversaciones para almacenar y recuperar el estado de la conversación a través de llamadas a la API de respuesta. Crea conversaciones, añade elementos (mensajes de usuario, mensajes del asistente, mensajes del sistema) y mantiene el historial de la conversación. Soporta seguimiento de metadatos y gestión del estado del diálogo en múltiples turnos. x-displayName: Conversaciones - name: Guardrails description: >- API de salvaguardias de seguridad de IA para configurar la moderación de contenido y las políticas de seguridad. Configura listas de palabras prohibidas, detección de inyección de mensajes y prevención de filtración de mensajes del sistema. Las salvaguardias se aplican a todas las solicitudes de una cuenta y se pueden probar antes del despliegue. x-displayName: Barandillas - name: Models description: >- API de listado de modelos para descubrir modelos disponibles. Devuelve IDs de modelos, propiedad y metadatos para todos los modelos registrados en la puerta de enlace. x-displayName: Modelos - name: Skills description: >- API de habilidades para gestionar paquetes de instrucciones y archivos versionados siguiendo el estándar de Habilidades del Agente. Crea, versiona y descarga paquetes de habilidades reutilizables que incluyen manifiestos SKILL.md para entornos de agentes. x-displayName: Habilidades - name: Chat Completions description: >- **Obsoleto: Usa la API de Respuestas (`/api/v1/llm/responses`) en su lugar.** Puntos finales de completación de chat con soporte para transmisión, llamadas a herramientas y múltiples proveedores. x-deprecated: true x-displayName: Completaciones de Chat - name: Batches x-displayName: Lotes - name: Evals x-displayName: Evaluaciones - name: Fine-Tuning x-displayName: Ajuste fino - name: Memory Stores x-displayName: Almacenes de memoria - name: Prompts x-displayName: Sugerencias - name: API Key x-displayName: Clave de API - name: Organization x-displayName: Organización - name: Cluster Admin x-displayName: Administrador de clúster - name: Sessions description: Crear, inspeccionar, acceder y terminar sesiones de sandbox. x-displayName: Sesiones - name: Browser description: >- Conéctate a las sesiones del navegador a través del proxy del puerto de la puerta de enlace. Las sesiones del navegador exponen un punto final del Protocolo de DevTools de Chrome en el puerto 9222. x-displayName: Navegador - name: Execution description: >- Ejecutar comandos de shell y código dentro de una sesión de sandbox existente. x-displayName: Ejecución - name: Workspace description: >- Inspeccionar el manifiesto del espacio de trabajo, transferir archivos o archivos comprimidos, y descargar artefactos generados. x-displayName: Espacio de trabajo - name: Sandbox Usage description: >- Agrega estadísticas de uso de sandbox entre sesiones, ejecución y operaciones del espacio de trabajo. x-displayName: Uso de Sandbox - name: Sandbox Pricing description: >- Gestión de administrador de clúster de la tarjeta de tarifas de cómputo del entorno aislado utilizada para el gasto presupuestado. x-displayName: Precios de Sandbox - name: Agents description: Crea y gestiona definiciones de agentes reutilizables. x-displayName: Agentes - name: Agent Versions description: >- Inspeccionar el historial de configuración de un agente y revertir a una versión anterior. x-displayName: Versiones de Agente - name: Agent Runs description: >- Ejecutar agentes guardados e inspeccionar los resultados de ejecución persistidos. x-displayName: Ejecuta Agentes - name: Agent Connectors description: >- Conecta agentes guardados a canales de mensajería externos como Telegram, incluyendo intercambio de texto, fotos y documentos compatibles. x-displayName: Conectores de agentes - name: Agent Schedules description: >- Crea y gestiona ejecuciones de agentes programadas o recurrentes guardadas. x-displayName: Horarios de Agentes - name: schema-4_other x-displayName: otro - name: Budgets x-displayName: Presupuestos - name: Settings x-displayName: Configuración - name: Compute Jobs x-displayName: Trabajos de computación - name: Compute Services x-displayName: Servicios de computación - name: Compute Catalog x-displayName: Catálogo de cómputo - name: Compute Secrets x-displayName: Calcular secretos - name: Compute Usage x-displayName: Uso de cómputo - name: Compute Tenants x-displayName: Calcular inquilinos - description: Crear, listar, leer, actualizar y eliminar repositorios. name: Repositories x-displayName: Repositorios - description: >- Administrar los colaboradores explícitos de un repositorio (lectores/escritores). name: Collaborators x-displayName: Colaboradores paths: /api/v1/llm/evals/suites/{suite_id}/leaderboard-runs: get: tags: - Evals summary: Lista las ejecuciones de la clasificación para un conjunto de evaluación description: >- Devuelve en una sola solicitud las ejecuciones completadas más recientes de cada grupo de clasificación para una suite, con las asignaciones de grupo en `groups`. Un grupo es (model, tarea objetivo) para ejecuciones restringidas por task_ids y (model) para ejecuciones no restringidas (task_id null). Construye los tableros a partir de `groups`, no de run.models/run.task_ids: una ejecución devuelta puede nombrar modelos o tareas en cuyos grupos no quedó clasificada. `truncated: true` significa que un límite del servidor recortó el agregado; las ejecuciones completas se conservan en el orden (mejor rango, primer modelo, primera tarea, id), de modo que las ejecuciones más recientes de cada grupo sobreviven antes que los respaldos de cualquier grupo y no se descarta ningún grupo por ser antiguo. Reanuda un tablero truncado pasando `next_cursor` de vuelta como `cursor` y uniendo las respuestas. Consulta la documentación de evals para conocer la justificación del agrupamiento y las características de coste. operationId: listEvalSuiteLeaderboardRuns parameters: - name: suite_id in: path required: true schema: type: string example: eval_suite_aa87e2b1112a455b8deabed784372198 - name: suite_version in: query schema: type: integer minimum: 1 maximum: 2147483647 description: >- Limita la clasificación a ejecuciones registradas contra una versión de la suite. Las puntuaciones solo son comparables dentro de una versión, así que los consumidores de la tabla de clasificación deben pasar la versión que puntúan. Una versión que la suite no tiene devuelve una lista vacía, no un 404, así que se interpreta igual que una versión sin ejecuciones completadas todavía. allowEmptyValue: true example: 1 - name: per_group in: query schema: type: integer minimum: 1 maximum: 20 default: 5 description: >- Cuántas ejecuciones completadas más recientes conservar por grupo de clasificación. Un grupo es (modelo, tarea objetivo) para ejecuciones restringidas por task_ids — las importaciones históricas registran una ejecución por modelo y tarea, por lo que sus tableros se ensamblan con per_group=1 — y (modelo) para ejecuciones no restringidas, que cubren todas las tareas de su versión. Más de 1 permite a un consumidor recurrir a una ejecución anterior para una tarea cuya ejecución más reciente carece de estadísticas utilizables. allowEmptyValue: true example: 5 - name: model in: query schema: type: string minLength: 1 maxLength: 255 description: >- Limita el ranking a los grupos de un solo modelo. Útil cuando el consumidor ya conoce los ejes de su tablero; para descubrir y paginar más allá de una respuesta truncada, usa cursor/next_cursor. Un valor vacío se rechaza en lugar de tratarse como omitido. allowEmptyValue: true example: meetkai:qwen3.5-35b-a3b - name: cursor in: query schema: type: string minLength: 1 maxLength: 2048 description: >- Cursor opaco para reanudar a partir del next_cursor de una respuesta truncada anterior. Continúa la clasificación exactamente donde se detuvo la página anterior — dentro de un modelo o de un nivel de ranking cuando el corte cayó allí. Devuélvelo tal cual; un valor malformado provoca un 400. Paginado con un conjunto de filtros fijo, como el cursor de la lista de ejecuciones. allowEmptyValue: true - name: X-On-Behalf-Of in: header required: false schema: type: string description: Optional external end-user identifier forwarded by the API gateway. responses: '200': description: Está bien content: application/json: schema: type: object properties: object: const: eval.leaderboard_runs data: type: array items: type: object properties: id: type: string object: const: eval.run suite_id: type: string suite_version: type: integer minimum: -9007199254740991 maximum: 9007199254740991 suite_version_id: type: string status: $ref: '#/components/schemas/EvalRunStatus' models: type: array items: type: string task_ids: anyOf: - type: array items: type: string - type: 'null' judge_model: anyOf: - type: string - type: 'null' embedding_model: anyOf: - type: string - type: 'null' generation: type: object properties: instructions: type: string temperature: type: number minimum: 0 maximum: 2 top_p: type: number minimum: 0 maximum: 1 max_output_tokens: type: integer minimum: 1 maximum: 9007199254740991 max_gen_toks: type: integer minimum: 1 maximum: 9007199254740991 description: lm-eval alias for max_output_tokens. stop: anyOf: - type: string - type: array minItems: 1 items: type: string until: type: array minItems: 1 items: type: string description: lm-eval generate_until stop sequences. max_tool_calls: type: integer minimum: 1 maximum: 9007199254740991 reasoning: {} text: {} tools: type: array items: anyOf: - {} - type: 'null' tool_choice: {} parallel_tool_calls: type: boolean truncation: enum: - auto - disabled type: string service_tier: enum: - auto - default - flex - priority type: string presence_penalty: type: number minimum: -2 maximum: 2 frequency_penalty: type: number minimum: -2 maximum: 2 top_k: type: integer minimum: 0 maximum: 9007199254740991 min_p: type: number minimum: 0 maximum: 1 repetition_penalty: type: number minimum: 0 do_sample: type: boolean extra_body: type: object propertyNames: type: string additionalProperties: {} chat_template_kwargs: type: object propertyNames: type: string additionalProperties: {} prefill_think: anyOf: - type: boolean - type: string use_cache: type: boolean timeout_seconds: type: integer minimum: 1 maximum: 3600 max_retries: type: integer minimum: 0 maximum: 10 max_empty_retries: type: integer minimum: 0 maximum: 10 additionalProperties: {} request_counts: type: object properties: total: type: integer minimum: -9007199254740991 maximum: 9007199254740991 completed: type: integer minimum: -9007199254740991 maximum: 9007199254740991 failed: type: integer minimum: -9007199254740991 maximum: 9007199254740991 required: - total - completed - failed metrics: anyOf: - type: object propertyNames: type: string additionalProperties: {} - type: 'null' error: anyOf: - type: object propertyNames: type: string additionalProperties: {} - type: 'null' artifact_file_ids: type: array items: type: string metadata: type: object propertyNames: type: string maxLength: 64 additionalProperties: type: string maxLength: 512 created_at: type: integer minimum: -9007199254740991 maximum: 9007199254740991 started_at: anyOf: - type: integer minimum: -9007199254740991 maximum: 9007199254740991 - type: 'null' completed_at: anyOf: - type: integer minimum: -9007199254740991 maximum: 9007199254740991 - type: 'null' cancelled_at: anyOf: - type: integer minimum: -9007199254740991 maximum: 9007199254740991 - type: 'null' failed_at: anyOf: - type: integer minimum: -9007199254740991 maximum: 9007199254740991 - type: 'null' required: - id - object - suite_id - suite_version - suite_version_id - status - models - task_ids - judge_model - embedding_model - generation - request_counts - metrics - error - artifact_file_ids - metadata - created_at - started_at - completed_at - cancelled_at - failed_at description: The deduplicated runs behind `groups`, newest first. groups: type: array items: $ref: '#/components/schemas/EvalLeaderboardRunGroup' description: >- The server's group assignments — build boards from these, not from run.models/run.task_ids. Ordered by model, then task id with the covers-everything group first within each model, then rank; that ordering is contract. truncated: type: boolean description: >- True when a server ceiling trimmed the aggregate. Whole runs are kept in (rank, model, task) order — never dropped for being old; resume with `cursor: next_cursor`. next_cursor: anyOf: - type: string - type: 'null' description: >- Set when truncated: pass as `cursor` on the next request and union the responses until truncated is false to assemble the complete aggregate. Null when this response is complete. required: - object - data - groups - truncated - next_cursor example: object: eval.leaderboard_runs data: - id: eval_run_aa87e2b1112a455b8deabed784372198 object: eval.run suite_id: eval_suite_aa87e2b1112a455b8deabed784372198 suite_version: 1 suite_version_id: eval_sver_aa87e2b1112a455b8deabed784372198 status: in_progress models: - auto task_ids: null judge_model: auto embedding_model: auto generation: temperature: 0 max_output_tokens: 512 request_counts: total: 100 completed: 10 failed: 0 metrics: null error: null artifact_file_ids: [] metadata: purpose: mvp created_at: 1704067200 started_at: 1704067210 completed_at: null cancelled_at: null failed_at: null groups: - model: meetkai:qwen3.5-35b-a3b task_id: null rank: 1 run_id: eval_run_aa87e2b1112a455b8deabed784372198 truncated: false next_cursor: null security: - bearerAuth: [] x-codeSamples: - lang: python label: Python (SDK) source: |- from meetkai_mka1 import SDK with SDK( bearer_auth="", ) as sdk: res = sdk.llm.evals.list_suite_leaderboard_runs(suite_id="eval_suite_aa87e2b1112a455b8deabed784372198", suite_version=1, per_group=5, model="meetkai:qwen3.5-35b-a3b") # Handle response print(res) - lang: typescript label: Typescript (SDK) source: |- import { SDK } from "@meetkai/mka1"; const sdk = new SDK({ bearerAuth: "", }); async function run() { const result = await sdk.llm.evals.listSuiteLeaderboardRuns({ suiteId: "eval_suite_aa87e2b1112a455b8deabed784372198", suiteVersion: 1, model: "meetkai:qwen3.5-35b-a3b", }); console.log(result); } run(); - lang: csharp label: CSharp (SDK) source: >- using MeetKai.MKA1; using MeetKai.MKA1.Types.Components; using MeetKai.MKA1.Types.Requests; var sdk = new SDK(bearerAuth: ""); ListEvalSuiteLeaderboardRunsRequest req = new ListEvalSuiteLeaderboardRunsRequest() { SuiteId = "eval_suite_aa87e2b1112a455b8deabed784372198", SuiteVersion = 1, Model = "meetkai:qwen3.5-35b-a3b", }; var res = await sdk.Llm.Evals.ListSuiteLeaderboardRunsAsync(req); // handle response components: schemas: EvalRunStatus: enum: - queued - in_progress - finalizing - completed - failed - cancelling - cancelled type: string EvalLeaderboardRunGroup: type: object properties: model: type: string description: El modelo del grupo. task_id: anyOf: - type: string - type: 'null' description: >- La tarea objetivo del grupo, o nulo para el grupo per-model que cubre todo en el que se clasifican las ejecuciones sin restricciones (sin task_ids): esas ejecuciones cubren todas las tareas de su versión. rank: type: integer minimum: -9007199254740991 maximum: 9007199254740991 description: >- 1 es la ejecución completada más reciente del grupo. Los rangos ordenan las ejecuciones dentro de un grupo, pero no son índices de ranura: bajo truncamiento, los rangos supervivientes de un grupo pueden no ser contiguos. run_id: type: string description: >- La ejecución que mantiene este rango; el objeto de ejecución completo está en `data`. required: - model - task_id - rank - run_id securitySchemes: bearerAuth: type: http scheme: bearer bearerFormat: API Key description: >- Gateway auth: send `Authorization: Bearer `. For multi-user server-side integrations, you can also send `X-On-Behalf-Of: `. ````