Provedores próprios

Você pode usar a sua própria chave da OpenAI, da Anthropic, do Google Gemini ou de qualquer API compatível com a OpenAI pela mesma URL e com a mesma chave vai. Essas requisições vão direto ao provedor com a sua chave: quem cobra é o provedor, e a Veloz não desconta nada do saldo de IA. Elas funcionam até com o saldo zerado.

Assim o seu app fala com uma URL só, troca de modelo mudando um texto, usa um modelo do catálogo como reserva e mostra todas as requisições no mesmo painel de uso.

Provedores aceitos

OpenAI, Anthropic e Google aceitam uma chave cada, sempre com o mesmo identificador. Groq, DeepSeek, Mistral, xAI, Together AI, Fireworks AI e Cerebras já vêm com a URL e o identificador preenchidos, e você pode mudar os dois. Em Outra URL, vale qualquer API que siga o formato da OpenAI.

Adicionar um provedor

1. No painel, abra Inferência de IA > Provedores e escolha o provedor.
2. Cole a chave. O painel tem o link para a página de chaves de cada provedor.
3. Nas APIs compatíveis e em Outra URL, confira também:
   • Nome: como o provedor aparece no painel.
   • Identificador: o prefixo do model. Letras minúsculas, números e hífens, até 31 caracteres. openai, anthropic, google e veloz são reservados.
   • URL da API: a URL base, como https://api.exemplo.com/v1. Precisa usar https e apontar para um endereço público.

Antes de salvar, a Veloz pede ao provedor a lista de modelos com a sua chave. Se o provedor recusar, a chave não é salva e o painel mostra o erro. A chave é guardada criptografada, e depois disso o painel mostra só o final dela.

Chamar um modelo

Use o identificador do provedor, uma barra e o nome do modelo como o provedor conhece:

curl https://platform.onveloz.com/api/ai/v1/chat/completions \
  -H "Authorization: Bearer $VELOZ_AI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "anthropic/claude-haiku-4-5",
    "messages": [{ "role": "user", "content": "Olá!" }]
  }'

resposta = client.chat.completions.create(
    model="openai/gpt-4.1-mini",
    messages=[{"role": "user", "content": "Olá!"}],
)

Tudo depois da primeira barra vai para o provedor como está, mesmo que tenha outras barras: na Fireworks AI, por exemplo, fireworks/accounts/fireworks/models/<modelo>. Para ver os nomes que a sua chave alcança, clique em Modelos no provedor, em Provedores.

• Rotas: POST /chat/completions e POST /embeddings. As outras rotas atendem só os modelos do catálogo e respondem 400 com o código model_not_supported_for_endpoint.
• Campos: os campos da requisição (como temperature, tools e response_format) vão para o provedor do jeito que vieram.
• Limites: valem os limites da sua conta no provedor e os 300 por minuto da chave vai. Veja Erros e limites.

Anthropic

A API da Anthropic tem um formato próprio. Pela Veloz, você envia e recebe no formato da OpenAI, e a Veloz traduz nos dois sentidos:

• Mensagens de system viram as instruções do sistema da Anthropic.
• Streaming chega como eventos do formato da OpenAI, com usage no fim.
• Chamadas de ferramentas (tools, tool_choice e as respostas com tool_calls) funcionam como na OpenAI.
• Imagens em image_url funcionam com uma URL https ou com um data URL em base64. PDFs funcionam como data URL (data:application/pdf;base64,...).
• Sem max_tokens, a Veloz envia 4096, porque a Anthropic exige o campo.

A Anthropic não oferece embeddings.

Gerenciar

Cada provedor em Provedores tem:

• Ativo: desligue para pausar. Com o provedor pausado, as requisições para ele respondem 404 com o código provider_not_configured.
• Trocar chave: a chave nova passa pela mesma verificação antes de valer.
• Modelos: os modelos que a sua chave alcança.
• Remover: apaga a chave da Veloz.

Quem gerencia a cobrança da organização (donos e administradores, por padrão) adiciona, pausa, troca e remove provedores, e cada mudança fica em Organização > Atividade. Qualquer chave vai da organização usa os provedores ativos.

Custo

As requisições para os seus provedores não descontam créditos. Em Inferência de IA > Uso, cada uma aparece com uma estimativa em dólares pelo preço de tabela do provedor, quando o modelo é conhecido. O valor que vale é o da fatura do provedor.

Erros do provedor

Outros erros 4xx do provedor chegam com a mensagem dele. Com modelos de reserva, uma falha passa para o próximo modelo da lista.

Privacidade

Uma requisição para um provedor próprio sai do Brasil se o provedor estiver fora do país, e segue os termos do provedor. A Veloz não repassa os cabeçalhos da sua requisição ao provedor nem os cabeçalhos dele para você. O que a Veloz registra de cada requisição está em Uso e rastreamento.