> ## 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. # Obter histórico de disponibilidade do acelerador > Série temporal de disponibilidade segmentada por intervalos para um tipo de acelerador ao longo de uma janela, agregada entre provedores anônimos e fornecida a partir de agregações horárias. Inclui um perfil de hora do dia com 24 slots. As horas em que a plataforma fez consultas sem observar o acelerador são registradas como disponibilidade 0; uma janela sem observações retorna uma série vazia. ## OpenAPI ````yaml https://apigw.mka1.com/speakeasy.json?language=pt-BR get /api/v1/serving/accelerators/{name}/availability openapi: 3.1.1 info: title: MKA1 API version: 1.1.0 description: >- A API MKA1 é uma API RESTful que fornece acesso à plataforma MKA1. Aprenda como começar a usar a API e o SDK TypeScript [aqui](https://mka1.apidocumentation.com/guides/getting-started). license: name: Proprietário 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: >- Gerencie permissões para recursos LLM. Crie recursos, conceda/revoque permissões e exclua recursos. Apenas os proprietários dos recursos podem conceder, revogar ou excluir permissões. x-displayName: Autorização de Recurso - name: Embeddings description: >- Endpoints da API de incorporação de texto para gerar representações vetoriais de texto. Crie incorporações semânticas para busca, clustering e correspondência de similaridade usando vários modelos de incorporação. x-displayName: Incorporações - name: Feedback description: >- API de feedback do usuário para avaliar e comentar sobre as conclusões de chat. Coleta de classificações de positivo/negativo e feedback detalhado para melhorar as respostas do modelo e acompanhar a satisfação do usuário. x-displayName: Feedback - name: Images description: >- Pontos de extremidade da API de geração de imagens para criar imagens a partir de descrições de texto. Gere imagens com controle sobre tamanho, qualidade e estilo. x-displayName: Imagens - name: MCP Vault description: >- API do cofre MCP para armazenar configurações de servidor MCP de propriedade do usuário e credenciais criptografadas. Os agentes referenciam IDs de cofre para que os segredos sejam resolvidos apenas no momento da execução da ferramenta. x-displayName: Cofre MCP - name: Speech description: >- Pontos de extremidade da API de fala para processamento de áudio. Converta texto em fala com som natural (TTS) ou transcreva fala em texto (STT) em diferentes idiomas. x-displayName: Discurso - name: Usage description: >- API de rastreamento de uso e análise para monitoramento do consumo de tokens, contagem de solicitações e análise de custos. Veja estatísticas detalhadas por usuário, modelo e período de tempo. x-displayName: Uso - name: Extract description: >- API de extração de dados estruturados para extrair informações de arquivos. Defina esquemas JSON para extrair dados estruturados de imagens, PDFs e documentos. Suporta modelos de esquema reutilizáveis. x-displayName: Extração - name: Text Classification description: >- API de classificação de texto para categorizar textos em rótulos predefinidos. Use modelos de IA para classificar o conteúdo textual para análise de sentimento, categorização de tópicos e moderação de conteúdo. x-displayName: Classificação de Texto - name: Responses description: >- API de respostas com agentes para criar agentes de IA com uso autônomo de ferramentas. Crie assistentes conversacionais que podem usar pesquisa na web, operações de arquivos, geração de imagens, execução de código, simulação de uso de computador e integrações MCP. Suporta processamento em segundo plano, streaming e monitoramento de status em tempo real. x-displayName: Respostas - name: Files description: >- API de gerenciamento de arquivos para upload, armazenamento e gerenciamento de arquivos com expiração automática e integração com S3. Faça upload de arquivos que podem ser usados com Assistentes, Armazenamentos Vetoriais e outras funcionalidades. Os arquivos são armazenados no S3 com metadados rastreados no PostgreSQL. Suporta limpeza automática de arquivos expirados. x-displayName: Arquivos - name: Vector Stores description: >- API de armazenamento de vetores para armazenar e pesquisar documentos usando embeddings. Crie armazenamentos de vetores, faça upload de arquivos com divisão automática e geração de embeddings, e realize pesquisas semânticas. Os arquivos são processados de forma assíncrona usando fluxos de trabalho Temporais para durabilidade. Suporta limpeza automática de armazenamentos expirados e LanceDB para armazenamento eficiente de vetores. x-displayName: Armazenamentos de Vetores - name: Conversations description: >- API de gerenciamento de conversas para armazenar e recuperar o estado da conversa durante chamadas à API de Resposta. Crie conversas, adicione itens (mensagens do usuário, mensagens do assistente, mensagens do sistema) e mantenha o histórico da conversa. Suporta rastreamento de metadados e gerenciamento de estado de diálogo em múltiplas interações. x-displayName: Conversa - name: Guardrails description: >- API de diretrizes de segurança de IA para configurar moderação de conteúdo e políticas de segurança. Configure listas de palavras proibidas, detecção de injeção de prompts e prevenção de vazamento de prompts do sistema. As diretrizes aplicam-se a todas as solicitações de uma conta e podem ser testadas antes da implementação. x-displayName: Guarda-corpos - name: Models description: >- API de listagem de modelos para descobrir modelos disponíveis. Retorna IDs de modelos, propriedade e metadados de todos os modelos registrados no gateway. x-displayName: Modelos - name: Skills description: >- API de habilidades para gerenciar pacotes versionados de instruções e arquivos seguindo o padrão de Habilidades do Agente. Crie, versionar e baixe pacotes de habilidades reutilizáveis que incluam manifestos SKILL.md para ambientes de agentes. x-displayName: Habilidades - name: Chat Completions description: >- **Obsoleto: Use a API de Respostas (`/api/v1/llm/responses`) em vez disso.** Endpoints de conclusão de chat com suporte para streaming, chamadas de ferramentas e múltiplos provedores. x-deprecated: true x-displayName: Conclusões de Bate-Papo - name: Batches x-displayName: Lotes - name: Evals x-displayName: Avaliações - name: Fine-Tuning x-displayName: Ajuste Fino - name: Memory Stores x-displayName: Armazenamentos de Memória - name: Prompts x-displayName: Sugestões - name: API Key x-displayName: Chave da API - name: Organization x-displayName: Organização - name: Cluster Admin x-displayName: Administrador do cluster - name: Sessions description: Crie, inspecione, acesse e encerre sessões de sandbox. x-displayName: Sessões - name: Browser description: >- Conecte-se às sessões do navegador através do proxy da porta do gateway. As sessões do navegador expõem um endpoint do Chrome DevTools Protocol na porta 9222. x-displayName: Navegador - name: Execution description: >- Executar comandos shell e código dentro de uma sessão de sandbox existente. x-displayName: Execução - name: Workspace description: >- Inspecione o manifesto do espaço de trabalho, transfira arquivos ou arquivos compactados e baixe artefatos gerados. x-displayName: Espaço de trabalho - name: Sandbox Usage description: >- Agregue estatísticas de uso da sandbox entre sessões, execução e operações do espaço de trabalho. x-displayName: Uso do Sandbox - name: Sandbox Pricing description: >- Gerenciamento de cluster-admin da tabela de preços de computação da sandbox usada para gastos orçados. x-displayName: Preço da Sandbox - name: Agents description: Crie e gerencie definições de agentes reutilizáveis. x-displayName: Agentes - name: Agent Versions description: >- Inspecione o histórico de configuração de um agente e reverta para uma versão anterior. x-displayName: Versões do Agente - name: Agent Runs description: Execute agentes salvos e inspecione os resultados da execução persistidos. x-displayName: Executa Agente - name: Agent Connectors description: >- Conecte agentes salvos a canais de mensagens externos, como o Telegram, incluindo troca de texto, foto e documentos compatíveis. x-displayName: Conectores de Agente - name: Agent Schedules description: Crie e gerencie execuções de agentes salvos agendadas ou recorrentes. x-displayName: Agendas de Agentes - name: schema-4_other x-displayName: outro - name: Budgets x-displayName: Orçamentos - name: Settings x-displayName: Configurações - description: Servidores de inferência de longa duração. name: Deployments x-displayName: Implantações - description: Enviar, monitorar e cancelar trabalhos de fine-tuning. name: Fine-Tune Jobs x-displayName: Trabalhos de Ajuste Fino - description: Imagens de contêiner personalizadas para implantações e jobs. name: Container Images x-displayName: Imagens de contêineres - description: >- Conjuntos de dados de treinamento de primeira classe: referências registradas ou objetos enviados e confirmados. name: Datasets x-displayName: Conjuntos de dados - description: Armazenamento persistente para pesos e checkpoints. name: Volumes x-displayName: Volumes - description: Credenciais injetadas em seus workloads. name: Secrets x-displayName: Segredos - description: Tipos de aceleradores disponíveis (GPU, NPU, TPU). name: Accelerators x-displayName: Aceleradores - description: >- Pré-visualizações anônimas do provedor da elegibilidade de capacidade antes do envio. name: Eligibility x-displayName: Elegibilidade - description: Provisionamento da organização cluster-admin para serving. name: Serving Tenants x-displayName: Atendimento aos inquilinos - description: >- Catálogo gerenciado por cluster-admin de receitas de runtime de serving. O registro armazena um manifesto com digest fixado; apenas receitas habilitadas podem ser implantadas. name: Serving Recipes x-displayName: Receitas de Serviço - description: Agregados de custo e gasto calculados. name: Spend x-displayName: Gastar paths: /api/v1/serving/accelerators/{name}/availability: get: tags: - Accelerators summary: Obter histórico de disponibilidade do acelerador description: >- Série temporal de disponibilidade segmentada por intervalos para um tipo de acelerador ao longo de uma janela, agregada entre provedores anônimos e fornecida a partir de agregações horárias. Inclui um perfil de hora do dia com 24 slots. As horas em que a plataforma fez consultas sem observar o acelerador são registradas como disponibilidade 0; uma janela sem observações retorna uma série vazia. operationId: getAcceleratorAvailability parameters: - in: path name: name required: true schema: title: Name type: string - in: query name: window required: false schema: default: 7d description: Janela de retrospectiva para a série. 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: Resposta Bem-Sucedida '401': description: Token bearer ausente ou inválido. '403': content: application/json: schema: $ref: '#/components/schemas/ServingError' description: O serviço não está habilitado para o seu locatário. '404': content: application/json: schema: $ref: '#/components/schemas/ServingError' description: Recurso não encontrado. '422': content: application/json: schema: $ref: '#/components/schemas/ServingHTTPValidationError' description: Erro de Validação '501': content: application/json: schema: $ref: '#/components/schemas/ServingError' description: >- Os rollups de disponibilidade não estão disponíveis nesta implantação. 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: >- Série temporal de disponibilidade agrupada por intervalos para um acelerador ao longo de uma janela, atendida exclusivamente a partir de agregações horárias. As estimativas são honestas ou ausentes — nunca extrapoladas além das consultas observadas. properties: buckets: description: >- Buckets horários cobrindo as horas consultadas da janela, da mais antiga para a mais recente. Vazio quando nenhuma observação na janela carregou este acelerador em lugar nenhum: uma resposta honesta de ausência de dados, nunca uma série de zeros fabricados. items: $ref: '#/components/schemas/AcceleratorAvailabilityBucket' title: Buckets type: array by_provider: description: >- Presente somente quando o cluster não anonimiza os provedores; com a anonimização ativada, apenas a agregação entre provedores é enviada. 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 do dia em UTC de 24 slots mesclado ao longo da janela. Vazio quando buckets estiver vazio. 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: Envelope de erro padrão. 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: >- Um intervalo de disponibilidade horária para um acelerador, agregado entre provedores anônimos. properties: availability_ratio: description: >- Fração de consultas de capacidade bem-sucedidas no bucket nas quais a capacidade correspondente estava disponível. Horas consultadas sem nenhuma observação correspondente retornam 0. maximum: 1 minimum: 0 title: Availability Ratio type: number bucket_start: description: Início UTC da bucket horária. format: date-time title: Bucket Start type: string present_polls: description: >- Observações de sondagem bem-sucedidas que continham uma configuração correspondente neste bucket (0 quando o acelerador esteve ausente durante a hora inteira). title: Present Polls type: integer price_band: anyOf: - $ref: '#/components/schemas/AvailabilityPriceBand' - type: 'null' description: >- Nulo quando o bucket não tem observações precificadas; os preços nunca são extrapolados. title: Price Band required: - bucket_start - availability_ratio - present_polls title: AcceleratorAvailabilityBucket type: object AcceleratorProviderAvailability: description: >- Detalhamento por provedor dos mesmos buckets. Exibido somente quando o cluster não anonimiza os provedores. 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: Um slot do perfil de disponibilidade de hora do dia de 24 slots. properties: availability_ratio: description: >- Média não ponderada das razões de disponibilidade horária da janela que caem nesta hora do dia. Sem significado quando o número de amostras é 0. maximum: 1 minimum: 0 title: Availability Ratio type: number hour: description: Hora do dia em UTC. maximum: 23 minimum: 0 title: Hour type: integer samples: description: >- Número de intervalos de janela contribuindo para este slot. 0 significa nenhuma evidência para esta hora do dia. title: Samples type: integer required: - hour - availability_ratio - samples title: AcceleratorHourOfDaySlot type: object ErrorDetail: description: O corpo de uma resposta de erro. 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: >- Caminho JSON para a entrada inválida: o primeiro segmento indica onde ela está ("body", "query", "path" ou "request" quando nenhum local mais específico é conhecido), seguido por nomes de propriedades / índices de array, por exemplo ["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: >- Faixa de preço em USD por hora observada dentro de um bucket: mínimo/máximo exatos e a média ponderada pelas observações, agregados entre provedores anônimos. Os percentis são deliberadamente não disponibilizados: eles não são agregáveis entre provedores a partir de rollups. 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: `. ````