Mistral

Overview

O custo vem do próprio Mistral, pela Admin API (GET /v1/admin/usage): é o valor cobrado, com a moeda informada pela API — não uma estimativa por tabela de preço. Na tela Uso de IA, o serviço aparece marcado como custo medido (OpenAI e Anthropic aparecem como custo estimado, porque ali o custo é tokens × tabela de preço).

Limitações da própria API do Mistral

• Granularidade mensal. A API só reporta por mês — não há série diária.
• Quebra por categoria, não por modelo. O consumo vem por categoria de uso (chat, completion, OCR, áudio, fine-tuning…). Não dá para separar quanto custou cada modelo.
• Sem contagem de tokens. A tela mostra "tokens não expostos" para este provedor.

Requisitos

• Uma API key admin do workspace Mistral — a chave de inferência não funciona aqui
• Papel de administrador no CloudBroker

A chave admin tem escopo maior

A API de faturamento do Mistral só aceita chave admin, que dá acesso administrativo ao workspace inteiro — escopo maior que as chaves de OpenAI e Anthropic.

Guia de setup

O Mistral não fica no Marketplace de Conectores — ele é adicionado como serviço de IA:

1. Em app.cloudbroker.app.br, abra Uso de IA → + Conectar IA
2. Em Provedor, escolha Mistral
3. Cole a API Key ADMIN do workspace
4. Opcionalmente, dê um nome e escolha um grupo e um produto para atribuir o custo
5. Salve

Campos

Campo	Obrigatório	Descrição
provider	Sim	mistral
apiKey	Sim	API key admin do workspace
name	Não	Nome do serviço (padrão: mistral)
groupId	Não	Atribui o custo a um grupo do CloudBroker
appId	Não	Atribui o custo a um app do CloudBroker

Validação

A chave é validada contra a Admin API do Mistral antes de ser salva. Se o Mistral recusar (401/403), a conexão falha com a mensagem: confirme que é uma chave ADMIN do workspace. A mesma chave não pode estar vinculada a outro usuário do CloudBroker.

Dado coletado

Valor cobrado no mês, com quebra por categoria de uso.

Moeda diferente de USD não é convertida

Se o Mistral reportar o consumo em outra moeda (ex.: EUR), o valor não é convertido: o CloudBroker não tem fonte de câmbio para essa moeda. O serviço mostra o valor na moeda original, e esse valor fica fora do total em USD da tela, com uma ressalva.

Ainda não calibrado

O conector foi implementado a partir da documentação pública da Admin API e ainda não foi conferido contra uma fatura real do Mistral.

Segurança

A chave admin é cifrada com AES-256-GCM antes de persistir (campo apiKeyEnc) e nunca volta para o navegador — a listagem de serviços mostra a chave mascarada.