API compatível com a OpenAI para chat, embeddings, rerank e transcrição com modelos como Llama, Qwen, Gemma e Sabiazinho rodando no Brasil, paga com créditos via Pix ou cartão, e com a sua própria chave da OpenAI, Anthropic ou Google.

A Veloz AI é uma API de inferência compatível com a OpenAI. Você usa o SDK oficial da OpenAI (ou qualquer cliente que fale o mesmo formato), troca a URL base e a chave, e chama modelos como Llama, Qwen, Gemma e Sabiazinho para chat, embeddings, rerank e transcrição de áudio. Os modelos rodam no Brasil.

URL base:

https://platform.onveloz.com/api/ai/v1

Como funciona

A mesma URL e a mesma chave vai atendem dois tipos de modelo:

Modelos do catálogo da Veloz: rodam no Brasil e são pagos com créditos de IA. A cobrança é pré-paga: você adiciona créditos via Pix ou cartão de crédito e cada requisição desconta do saldo pelo que usou, em tokens ou em segundos de áudio. Os créditos de IA são separados do plano: não entram na fatura mensal e funcionam em qualquer plano. Veja Modelos e preços.
Modelos dos seus provedores: você cadastra a sua chave da OpenAI, da Anthropic, do Google Gemini ou de outra API compatível e chama esses modelos pela Veloz. Quem cobra é o provedor; a Veloz não desconta nada do saldo. Veja Provedores próprios.

Numa mesma requisição, dá para listar modelos de reserva dos dois tipos: se o primeiro falhar, o próximo responde. Veja Roteamento com reserva.

Comece em 2 minutos

1. Crie uma chave

No painel, abra Inferência de IA e crie uma chave de API. Pela CLI:

veloz ai keys create meu-app

A chave começa com vai e aparece uma única vez. Guarde em uma variável de ambiente:

export VELOZ_AI_KEY=vai_sua_chave

2. Adicione créditos

No painel, em Inferência de IA, clique em adicionar créditos, informe o valor e pague com Pix ou cartão de crédito. Pela CLI, a recarga é por Pix:

veloz ai credits add 25

A CLI pede o nome e o CPF ou CNPJ do pagador, mostra o código Pix copia e cola e um link com o QR Code, e espera a confirmação do pagamento. O saldo entra assim que o Pix é confirmado. Detalhes em Créditos e chaves.

Se você só vai usar os seus provedores, pule este passo: essas requisições não usam o saldo.

3. Faça a primeira chamada

curl https://platform.onveloz.com/api/ai/v1/chat/completions \
  -H "Authorization: Bearer $VELOZ_AI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "meta-llama-llama-3.1-8b-instruct",
    "messages": [{ "role": "user", "content": "Olá! Em uma frase, o que você sabe fazer?" }]
  }'

Pronto. A resposta tem o mesmo formato da OpenAI, com o campo usage mostrando os tokens cobrados.

SDK da OpenAI

Qualquer SDK da OpenAI funciona: basta apontar a URL base para a Veloz.

Python

pip install openai

import os
from openai import OpenAI
 
client = OpenAI(
    base_url="https://platform.onveloz.com/api/ai/v1",
    api_key=os.environ["VELOZ_AI_KEY"],
)
 
resposta = client.chat.completions.create(
    model="meta-llama-llama-3.1-8b-instruct",
    messages=[{"role": "user", "content": "Resuma o que é Pix em uma frase."}],
)
 
print(resposta.choices[0].message.content)
print(resposta.usage)

JavaScript / TypeScript

npm install openai

import OpenAI from "openai";
 
const client = new OpenAI({
  baseURL: "https://platform.onveloz.com/api/ai/v1",
  apiKey: process.env.VELOZ_AI_KEY,
});
 
const resposta = await client.chat.completions.create({
  model: "meta-llama-llama-3.1-8b-instruct",
  messages: [{ role: "user", content: "Resuma o que é Pix em uma frase." }],
});
 
console.log(resposta.choices[0].message.content);
console.log(resposta.usage);

Frameworks que aceitam uma URL base compatível com a OpenAI (Vercel AI SDK, LangChain, LlamaIndex e outros) funcionam da mesma forma: configure a URL base e a chave.

O que dá para fazer

Rota	Para quê	Página
`POST /chat/completions`	Conversas, com ou sem streaming	Chat e streaming
`POST /completions`	Texto a partir de um prompt cru	Chat e streaming
`POST /embeddings`	Vetores para busca semântica e RAG	Embeddings e rerank
`POST /rerank`	Ordenar documentos pela relevância	Embeddings e rerank
`POST /audio/transcriptions`	Transcrever áudio	Transcrição de áudio
`GET /models`	Listar os modelos do catálogo	Modelos e preços

No painel

Tudo fica em Inferência de IA, no menu do painel:

Visão geral: saldo, gasto e requisições dos últimos 30 dias, os modelos mais usados e a URL base.
Playground: converse com os modelos do catálogo sem escrever código.
Modelos: o catálogo com os preços atuais.
Chaves de API: crie e revogue chaves vai.
Provedores: cadastre as suas chaves da OpenAI, Anthropic, Google e APIs compatíveis.
Uso: gasto por modelo e por dia, e o detalhe de cada requisição. Veja Uso e rastreamento.
Créditos: recargas por Pix ou cartão.

Para os códigos de erro e os limites de uso, veja Erros e limites.