Mono AI

Documentação

Comece com uma chamada.

Uma URL, uma chave e o modelo auto. Você organiza os destinos no painel; seu código continua chamando a mesma API.

01

Crie sua conta

Entre no painel e confira o plano e a cota de tokens disponíveis.

02

Crie uma chave

Na seção Chaves, dê um nome ao projeto. Copie a chave no momento da criação; o segredo completo aparece uma única vez.

03

Faça a chamada

Envie a chave como Bearer e use auto no campo model. A mesma chave serve para a rota da Mono e para seus provedores conectados.

Exemplo

Primeira chamada

Troque SUA_CHAVE_MONO pela chave que você criou. A URL base para clientes compatíveis com OpenAI é http://172.16.1.8:3000/v1.

Abrir minhas chaves 
curl http://172.16.1.8:3000/v1/chat/completions \
  -H "Authorization: Bearer SUA_CHAVE_MONO" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "auto",
    "messages": [{"role": "user", "content": "Olá!"}],
    "max_tokens": 1024
  }'

Referência rápida

Autenticação

Envie Authorization: Bearer SUA_CHAVE_MONO em cada chamada. Revogue uma chave vazada em Chaves e crie outra para o projeto.

Rotas e fallback

O modelo público é auto. A seção Roteamento mostra a ordem dos destinos. Quando um destino falha, o gateway tenta o próximo conforme a configuração da rota. Desconectar um provedor da fila não apaga sua credencial.

Ferramentas

A Mono encaminha tools, tool_choice, resultados de ferramentas e tool_calls em streaming. No OpenWebUI, use Function Calling: Native e habilite Builtin Tools no modelo auto. O modo Legacy transforma ferramentas em texto e pode exibir JSON ou raciocínio bruto na conversa.

Uso e limites

Tokens de entrada e saída entram nas cotas diárias e mensais do plano, inclusive ao usar provedores próprios. RPM, TPM e chamadas paralelas também dependem do plano. Em auto, se o cliente pedir uma saída maior que o plano comporta por minuto, a Mono reduz esse máximo e devolve o teto aplicado no cabeçalho X-Mono-Output-Token-Cap. Consulte os números atuais em Uso e limites.

Erros comuns

401: chave inválida ou conta bloqueada. 429: cota ou limite do gateway atingido. 502/503: gateway indisponível; tente novamente. A resposta inclui um código de erro para identificar cotas diária e mensal.

A URL acima deve usar HTTPS e um domínio público antes da abertura do serviço à internet.