Fazer deploy
docs

Créditos e chaves

Recarregue o saldo de IA da organização por Pix ou cartão, a partir de R$ 25,00, e crie, liste e revogue as chaves de API da Veloz AI pelo painel ou pela CLI.

Os modelos do catálogo são pagos com créditos pré-pagos, separados da fatura da Veloz. As chamadas são autenticadas com chaves vai. Os dois são da organização: todas as chaves usam o mesmo saldo.

Créditos

  • Recarga mínima: R$ 25,00.
  • Pagamento: Pix ou cartão de crédito. O código Pix vale por 1 hora; depois disso, gere outro. O cartão é pago na página da Stripe e só pelo painel; a CLI recarrega por Pix.
  • Quem pode recarregar: quem tem permissão de gerenciar a cobrança da organização.
  • Saldo zerado: os modelos do catálogo respondem 402 com o código insufficient_credits até a próxima recarga. Uma requisição que já começou termina normalmente, mesmo que o saldo fique um pouco negativo; a diferença sai da próxima recarga.

Os provedores próprios não usam créditos e continuam respondendo com o saldo zerado. Se você só usa provedores próprios, não precisa recarregar.

No painel, abra Inferência de IA > Créditos para recarregar e ver as movimentações. Pela CLI:

veloz ai credits                    # saldo, gasto dos últimos 30 dias e últimas movimentações
veloz ai credits add 50 --name "Maria Silva" --tax-id 123.456.789-09

Em scripts e agentes, passe --name e --tax-id (CPF ou CNPJ do titular). Pelo servidor MCP da CLI, ai_credits_add devolve o código Pix na hora, sem esperar o pagamento; consulte ai_credits depois para ver o novo saldo.

O gasto por modelo e por dia está em Uso e rastreamento.

Chaves de API

Toda chamada usa uma chave vai no cabeçalho Authorization:

Authorization: Bearer vai_sua_chave

Crie as chaves em Inferência de IA > Chaves de API ou pela CLI:

veloz ai keys list                  # nome, início da chave e último uso
veloz ai keys create producao       # mostra a chave uma única vez
veloz ai keys revoke <keyId>        # as requisições com ela passam a falhar na hora

Qualquer membro da organização pode criar e revogar chaves. Crie uma chave por app ou ambiente: assim você revoga uma sem derrubar as outras, e o detalhe de cada requisição em Uso mostra qual chave fez a chamada.

Uma chave vai chama os modelos do catálogo e os provedores próprios ativos da organização. Chaves de outras partes da Veloz não funcionam na Veloz AI e respondem 403.

Segurança: a chave dá acesso ao saldo de IA e aos provedores da organização. Guarde em uma variável de ambiente (no seu serviço da Veloz, em Variáveis de ambiente), nunca no código do navegador e nunca no Git. Se uma chave vazar, revogue e crie outra.