> ## 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. # Obtener el historial de disponibilidad del acelerador > Serie temporal de disponibilidad agrupada para un tipo de acelerador durante una ventana, agregada entre proveedores anónimos y servida a partir de agregaciones horarias. Incluye un perfil de hora del día de 24 intervalos. Las horas en que la plataforma hizo consultas sin observar el acelerador se leen como disponibilidad 0; una ventana sin observaciones en absoluto devuelve una serie vacía. ## OpenAPI ````yaml https://apigw.mka1.com/speakeasy.json?language=es get /api/v1/serving/accelerators/{name}/availability 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 - description: Servidores de inferencia de larga duración. name: Deployments x-displayName: Implementaciones - description: Enviar, monitorear y cancelar trabajos de ajuste fino. name: Fine-Tune Jobs x-displayName: Trabajos de ajuste fino - description: Imágenes de contenedor personalizadas para implementaciones y trabajos. name: Container Images x-displayName: Imágenes de contenedores - description: >- Conjuntos de datos de entrenamiento de primera clase: referencias registradas u objetos cargados y confirmados. name: Datasets x-displayName: Conjuntos de datos - description: Almacenamiento persistente para pesos y puntos de control. name: Volumes x-displayName: Volúmenes - description: Credenciales inyectadas en tus cargas de trabajo. name: Secrets x-displayName: Secretos - description: Tipos de aceleradores disponibles (GPU, NPU, TPU). name: Accelerators x-displayName: Aceleradores - description: >- Vistas previas de elegibilidad de capacidad previas a la presentación, anónimas para el proveedor. name: Eligibility x-displayName: Elegibilidad - description: >- Aprovisionamiento de organización de administrador del clúster para servicio. name: Serving Tenants x-displayName: Sirviendo a los inquilinos - description: >- Catálogo administrado por el administrador del clúster de recetas de tiempo de ejecución de servicio. El registro almacena un manifiesto anclado por digest; solo las recetas habilitadas pueden desplegarse. name: Serving Recipes x-displayName: Recetas de servicio - description: Agregados de costo y gasto calculados. name: Spend x-displayName: Gastar paths: /api/v1/serving/accelerators/{name}/availability: get: tags: - Accelerators summary: Obtener el historial de disponibilidad del acelerador description: >- Serie temporal de disponibilidad agrupada para un tipo de acelerador durante una ventana, agregada entre proveedores anónimos y servida a partir de agregaciones horarias. Incluye un perfil de hora del día de 24 intervalos. Las horas en que la plataforma hizo consultas sin observar el acelerador se leen como disponibilidad 0; una ventana sin observaciones en absoluto devuelve una serie vacía. operationId: getAcceleratorAvailability parameters: - in: path name: name required: true schema: title: Name type: string - in: query name: window required: false schema: default: 7d description: Ventana de retrospectiva para la serie. enum: - 24h - 7d - 30d title: Window type: string - 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': content: application/json: schema: $ref: '#/components/schemas/AcceleratorAvailability' description: Respuesta Exitosa '401': description: Falta el token de portador o no es válido. '403': content: application/json: schema: $ref: '#/components/schemas/ServingError' description: El servicio no está habilitado para su inquilino. '404': content: application/json: schema: $ref: '#/components/schemas/ServingError' description: Recurso no encontrado. '422': content: application/json: schema: $ref: '#/components/schemas/ServingHTTPValidationError' description: Error de validación '501': content: application/json: schema: $ref: '#/components/schemas/ServingError' description: >- Los acumulados de disponibilidad no están disponibles en esta implementación. security: - bearerAuth: [] x-codeSamples: - lang: python label: Python (SDK) source: |- from meetkai_mka1 import SDK with SDK( bearer_auth="", ) as sdk: res = sdk.serving.accelerators.availability(name="", window="7d") # 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.serving.accelerators.availability({ name: "", }); console.log(result); } run(); - lang: csharp label: CSharp (SDK) source: |- using MeetKai.MKA1; using MeetKai.MKA1.Types.Components; var sdk = new SDK(bearerAuth: ""); var res = await sdk.Serving.Accelerators.AvailabilityAsync( name: "", window: MeetKai.MKA1.Types.Requests.Window.Sevend ); // handle response components: schemas: AcceleratorAvailability: description: >- Serie temporal de disponibilidad agrupada por intervalos para un acelerador durante una ventana, servida exclusivamente a partir de agregados horarios. Las estimaciones son honestas o inexistentes; nunca extrapoladas más allá de las sondeos observados. properties: buckets: description: >- Cubos por hora que cubren las horas consultadas de la ventana, de la más antigua a la más reciente. Vacío cuando ninguna observación en la ventana llevaba este acelerador en ninguna parte: una respuesta sincera de ausencia de datos, nunca una serie de ceros inventados. items: $ref: '#/components/schemas/AcceleratorAvailabilityBucket' title: Buckets type: array by_provider: description: >- Presente solo cuando el clúster no anonimiza a los proveedores; con el anonimato activado, solo se envía el agregado entre proveedores. items: $ref: '#/components/schemas/AcceleratorProviderAvailability' title: By Provider type: array class: enum: - gpu - cpu title: Class type: string hour_of_day: description: >- Perfil de hora del día UTC de 24 intervalos fusionado a lo largo de la ventana. Vacío cuando buckets está vacío. items: $ref: '#/components/schemas/AcceleratorHourOfDaySlot' title: Hour Of Day type: array name: title: Name type: string window: enum: - 24h - 7d - 30d title: Window type: string required: - name - class - window - buckets - hour_of_day title: AcceleratorAvailability type: object ServingError: description: Envolvente de error estándar. properties: error: $ref: '#/components/schemas/ErrorDetail' required: - error title: ServingError type: object ServingHTTPValidationError: properties: detail: items: $ref: '#/components/schemas/ServingValidationError' title: Detail type: array title: ServingHTTPValidationError type: object AcceleratorAvailabilityBucket: description: >- Un intervalo de disponibilidad de una hora para un acelerador, agregado a través de proveedores anónimos. properties: availability_ratio: description: >- Fracción de sondeos de capacidad exitosos en el bucket en el que había capacidad coincidente disponible. Las horas sondeadas sin ninguna observación coincidente se leen como 0. maximum: 1 minimum: 0 title: Availability Ratio type: number bucket_start: description: Inicio UTC del intervalo horario. format: date-time title: Bucket Start type: string present_polls: description: >- Observaciones de sondeo exitosas que llevaron una configuración coincidente en este bucket (0 cuando el acelerador estuvo ausente durante toda la hora). title: Present Polls type: integer price_band: anyOf: - $ref: '#/components/schemas/AvailabilityPriceBand' - type: 'null' description: >- Nulo cuando el cubo no tiene observaciones con precio; los precios nunca se extrapolan. title: Price Band required: - bucket_start - availability_ratio - present_polls title: AcceleratorAvailabilityBucket type: object AcceleratorProviderAvailability: description: >- Desglose por proveedor de los mismos compartimentos. Se sirve solo cuando el clúster no anonimiza a los proveedores. properties: buckets: items: $ref: '#/components/schemas/AcceleratorAvailabilityBucket' title: Buckets type: array provider: title: Provider type: string required: - provider - buckets title: AcceleratorProviderAvailability type: object AcceleratorHourOfDaySlot: description: Un intervalo de la disponibilidad por hora del día de 24 intervalos. properties: availability_ratio: description: >- Media no ponderada de las proporciones de disponibilidad horaria de la ventana que caen en esta hora del día. Sin sentido cuando el número de muestras es 0. maximum: 1 minimum: 0 title: Availability Ratio type: number hour: description: Hora UTC del día. maximum: 23 minimum: 0 title: Hour type: integer samples: description: >- Número de cubos de ventana que contribuyen a este intervalo. 0 significa que no hay evidencia para esta hora del día. title: Samples type: integer required: - hour - availability_ratio - samples title: AcceleratorHourOfDaySlot type: object ErrorDetail: description: El cuerpo de una respuesta de error. properties: code: examples: - tenant_not_provisioned title: Code type: string message: type: string title: Message type: examples: - authorization_error title: Type type: string required: - code - message - type title: ErrorDetail type: object ServingValidationError: properties: loc: description: >- Ruta JSON a la entrada infractora: el primer segmento indica dónde se encuentra ("body", "query", "path" o "request" cuando no se conoce una ubicación más específica), seguido de nombres de propiedades / índices de arrays, por ejemplo ["body", "scaling", "min_containers"]. items: anyOf: - type: string - type: integer title: Location type: array msg: type: string title: Message type: type: string title: Error Type required: - loc - msg - type title: ServingValidationError type: object AvailabilityPriceBand: description: >- Banda de precios en USD por hora observada dentro de un bucket: mínimo/máximo exactos y promedio ponderado por observaciones, fusionados entre proveedores anónimos. Los percentiles no se ofrecen deliberadamente: no son combinables entre proveedores a partir de agregaciones. properties: avg: title: Avg type: number max: title: Max type: number min: title: Min type: number required: - min - avg - max title: AvailabilityPriceBand type: object 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: `. ````