> ## 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. # Atualizar um modelo pertencente ao cluster > Atualiza parcialmente um modelo pertencente ao operador e adicionado via API. Apenas os campos fornecidos são alterados. Somente administrador do cluster. ## OpenAPI ````yaml https://apigw.mka1.com/speakeasy.json?language=pt-BR patch /api/v1/llm/models/registry/cluster/{id} 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: Tables description: Gerenciar esquemas de tabelas, operações de dados, pesquisa e índices. x-displayName: Tabelas - name: Text Store description: >- Gerencie armazenamentos de texto com busca híbrida (vetorial + texto completo) e conjuntos de texto agrupados. x-displayName: Loja de Texto - name: GraphRAG description: >- Construa e consulte gráficos de conhecimento leves respaldados por Redis e LanceDB. x-displayName: GraphRAG - 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 Schedules description: Crie e gerencie execuções de agentes salvos agendadas ou recorrentes. x-displayName: Agendas de Agentes - name: schema-5_other x-displayName: outro - name: Budgets x-displayName: Orçamentos - name: Settings x-displayName: Configurações - name: Deployments description: Servidores de inferência de longa duração. x-displayName: Implantações - name: Fine-Tune Jobs description: Enviar, monitorar e cancelar trabalhos de fine-tuning. x-displayName: Trabalhos de Ajuste Fino - name: Container Images description: Imagens de contêiner personalizadas para implantações e jobs. x-displayName: Imagens de contêineres - name: Serving Models description: Modelos registrados para implantação e ajuste fino. x-displayName: Servindo Modelos - name: Volumes description: Armazenamento persistente para pesos e checkpoints. x-displayName: Volumes - name: Secrets description: Credenciais injetadas em seus workloads. x-displayName: Segredos - name: Accelerators description: Tipos de aceleradores disponíveis (GPU, NPU, TPU). x-displayName: Aceleradores paths: /api/v1/llm/models/registry/cluster/{id}: patch: tags: - Models summary: Atualizar um modelo pertencente ao cluster description: >- Atualiza parcialmente um modelo pertencente ao operador e adicionado via API. Apenas os campos fornecidos são alterados. Somente administrador do cluster. operationId: updateClusterRegistryModel parameters: - name: id in: path required: true schema: type: string example: meetkai:my-custom-chat-v1 requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/UpdateRegistryModelRequest' example: displayName: My Custom Chat v2 rpm: 240 defaultParams: temperature: 0.1 topP: 0.9 responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/RegistryModelResponse' example: id: meetkai:my-custom-chat-v1 provider: openai-compatible model_id: my-custom-chat-v1 source: database immutable: false definition: id: meetkai:my-custom-chat-v1 provider: openai-compatible modelId: my-custom-chat-v1 displayName: My Custom Chat v2 baseUrl: https://models.example.com/v1 apiFormat: responses created: 1704067200 auth: type: api-key value: '****' capabilities: modalities: input: - text output: - text reasoning: true supportsTemperature: true supportsTopP: true contextWindow: 131072 rpm: 240 defaultParams: temperature: 0.1 topP: 0.9 hidden: false healthCheck: mode: preflight path: /models source: database immutable: false health: is_available: true last_health_check: 1704067200000 error: null created_at: 1704067200000 updated_at: 1704240000000 security: - bearerAuth: [] x-codeSamples: - lang: csharp label: CSharp (SDK) source: |- using MeetKai.MKA1; using MeetKai.MKA1.Types.Components; var sdk = new SDK(bearerAuth: ""); var res = await sdk.Llm.Models.UpdateClusterRegistryModelAsync( id: "meetkai:my-custom-chat-v1", body: new MeetKai.MKA1.Types.Components.UpdateRegistryModelRequest() { DisplayName = "My Custom Chat v2", Rpm = 240, DefaultParams = new UpdateRegistryModelRequestDefaultParams() { Temperature = 0.1D, TopP = 0.9D, }, } ); // handle response - lang: python label: Python (SDK) source: |- from meetkai_mka1 import SDK with SDK( bearer_auth="", ) as sdk: res = sdk.llm.models.update_cluster_registry_model(id="meetkai:my-custom-chat-v1", display_name="My Custom Chat v2", api_format="tts", rpm=240, default_params={ "temperature": 0.1, "top_p": 0.9, }) # 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.models.updateClusterRegistryModel({ id: "meetkai:my-custom-chat-v1", updateRegistryModelRequest: { displayName: "My Custom Chat v2", rpm: 240, defaultParams: { temperature: 0.1, topP: 0.9, }, }, }); console.log(result); } run(); components: schemas: UpdateRegistryModelRequest: type: object properties: provider: type: string modelId: type: string displayName: anyOf: - type: string - type: 'null' baseUrl: anyOf: - type: string format: uri - type: 'null' apiFormat: $ref: '#/components/schemas/AutoEndpoint' apiProviderType: enum: - groq - azure - meetkai - meetkaiGateway - fal - openai created: type: integer minimum: 0 maximum: 9007199254740991 auth: anyOf: - type: object properties: type: const: api-key value: type: string envVar: type: string headerName: type: string required: - type additionalProperties: false - type: object properties: type: const: custom-headers headers: type: object propertyNames: type: string additionalProperties: type: string envVars: type: object propertyNames: type: string additionalProperties: type: string required: - type - headers additionalProperties: false - type: object properties: type: const: none required: - type additionalProperties: false - type: object properties: type: const: composite strategies: type: array minItems: 1 items: anyOf: - type: object properties: type: const: api-key value: type: string envVar: type: string headerName: type: string required: - type additionalProperties: false - type: object properties: type: const: custom-headers headers: type: object propertyNames: type: string additionalProperties: type: string envVars: type: object propertyNames: type: string additionalProperties: type: string required: - type - headers additionalProperties: false - type: object properties: type: const: none required: - type additionalProperties: false - type: object properties: type: const: composite strategies: type: array minItems: 1 items: anyOf: - type: object properties: type: const: api-key value: type: string envVar: type: string headerName: type: string required: - type additionalProperties: false - type: object properties: type: const: custom-headers headers: type: object propertyNames: type: string additionalProperties: type: string envVars: type: object propertyNames: type: string additionalProperties: type: string required: - type - headers additionalProperties: false - type: object properties: type: const: none required: - type additionalProperties: false - type: object properties: type: const: composite strategies: {} required: - type additionalProperties: false required: - type - strategies additionalProperties: false required: - type - strategies additionalProperties: false capabilities: type: object properties: modalities: type: object properties: input: type: array minItems: 1 items: enum: - text - image - audio - video output: type: array minItems: 1 items: enum: - text - image - audio - video required: - input - output additionalProperties: false reasoning: type: boolean supportedBase64Formats: type: array items: type: string supportsCompletionVideoUrlMessage: type: boolean supportsTemperature: type: boolean supportsTopP: type: boolean maxImageResolution: type: object properties: maxWidth: type: integer minimum: -9007199254740991 maximum: 9007199254740991 exclusiveMinimum: 0 maxHeight: type: integer minimum: -9007199254740991 maximum: 9007199254740991 exclusiveMinimum: 0 required: - maxWidth - maxHeight additionalProperties: false minImageResolution: type: object properties: maxWidth: type: integer minimum: -9007199254740991 maximum: 9007199254740991 exclusiveMinimum: 0 maxHeight: type: integer minimum: -9007199254740991 maximum: 9007199254740991 exclusiveMinimum: 0 required: - maxWidth - maxHeight additionalProperties: false required: - modalities - reasoning additionalProperties: false contextWindow: anyOf: - type: integer minimum: -9007199254740991 maximum: 9007199254740991 exclusiveMinimum: 0 - type: 'null' rpm: anyOf: - type: integer minimum: -9007199254740991 maximum: 9007199254740991 exclusiveMinimum: 0 - type: 'null' rateLimits: anyOf: - type: array items: type: object properties: scope: enum: - global - org - user - apiKey - externalUser rpm: type: integer minimum: -9007199254740991 maximum: 9007199254740991 exclusiveMinimum: 0 duration: type: integer minimum: -9007199254740991 maximum: 9007199254740991 exclusiveMinimum: 0 queue: type: object properties: maxDepth: type: integer minimum: -9007199254740991 maximum: 1000 exclusiveMinimum: 0 maxWaitMs: type: integer minimum: -9007199254740991 maximum: 120000 exclusiveMinimum: 0 required: - maxDepth - maxWaitMs additionalProperties: false required: - scope - rpm additionalProperties: false - type: 'null' defaultParams: anyOf: - type: object properties: temperature: type: number minimum: 0 maximum: 2 topP: type: number minimum: 0 maximum: 1 presencePenalty: type: number minimum: -2 maximum: 2 frequencyPenalty: type: number minimum: -2 maximum: 2 additionalProperties: false - type: 'null' rerouteRules: anyOf: - type: array items: type: object properties: trigger: anyOf: - type: object properties: type: const: input-modality modality: enum: - text - image - audio - video required: - type - modality additionalProperties: false - type: object properties: type: const: base64-input required: - type additionalProperties: false - type: object properties: type: const: context-exceeded required: - type additionalProperties: false - type: object properties: type: const: error-fallback required: - type additionalProperties: false targetModelId: type: string preserveParams: type: boolean log: type: boolean required: - trigger - targetModelId additionalProperties: false - type: 'null' hidden: anyOf: - type: boolean - type: 'null' embeddingLimits: anyOf: - type: object properties: maxBatchSize: type: integer minimum: -9007199254740991 maximum: 9007199254740991 exclusiveMinimum: 0 dimensions: anyOf: - type: integer minimum: -9007199254740991 maximum: 9007199254740991 exclusiveMinimum: 0 - type: object properties: min: type: integer minimum: -9007199254740991 maximum: 9007199254740991 exclusiveMinimum: 0 max: type: integer minimum: -9007199254740991 maximum: 9007199254740991 exclusiveMinimum: 0 default: type: integer minimum: -9007199254740991 maximum: 9007199254740991 exclusiveMinimum: 0 required: - min - max - default additionalProperties: false additionalProperties: false - type: 'null' healthCheck: anyOf: - anyOf: - type: object properties: mode: const: 'off' required: - mode additionalProperties: false - type: object properties: mode: const: preflight path: type: string minLength: 1 method: enum: - GET - HEAD timeoutMs: type: integer minimum: -9007199254740991 maximum: 9007199254740991 exclusiveMinimum: 0 cacheTtlSeconds: type: integer minimum: -9007199254740991 maximum: 9007199254740991 exclusiveMinimum: 0 required: - mode - path additionalProperties: false - type: object properties: mode: const: periodic intervalSeconds: type: integer minimum: -9007199254740991 maximum: 9007199254740991 exclusiveMinimum: 0 path: type: string minLength: 1 method: enum: - GET - HEAD timeoutMs: type: integer minimum: -9007199254740991 maximum: 9007199254740991 exclusiveMinimum: 0 cacheTtlSeconds: type: integer minimum: -9007199254740991 maximum: 9007199254740991 exclusiveMinimum: 0 required: - mode - intervalSeconds - path additionalProperties: false - type: 'null' RegistryModelResponse: type: object properties: id: type: string provider: type: string model_id: type: string source: type: string immutable: type: boolean definition: type: object propertyNames: type: string additionalProperties: {} health: type: object properties: is_available: type: boolean last_health_check: anyOf: - type: number - type: 'null' error: anyOf: - type: string - type: 'null' required: - is_available - last_health_check - error created_at: anyOf: - type: number - type: 'null' updated_at: anyOf: - type: number - type: 'null' required: - id - provider - model_id - source - immutable - definition - health - created_at - updated_at AutoEndpoint: enum: - responses - completions - embeddings - images - transcriptions - tts 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: `. ````