DOCUMENTAÇÃO

Integre a VOX em poucos minutos.

Chat, streaming, imagens, ferramentas, modelos, métricas de tokens, quotas e autenticação usando uma interface compatível com Chat Completions.

/v1/chat/completions/v1/models/v1/usage

Quickstart

Crie uma sk_vox_* no Console e use o domínio do VOX como Base URL.

curl https://vox-40v.pages.dev/v1/chat/completions \
  -H "Authorization: Bearer sk_vox_SUA_CHAVE" \
  -H "Content-Type: application/json" \
  -d '{"model":"vox","messages":[{"role":"user","content":"Olá"}]}'

Perfis VOX

vox, vox-free, vox-fast, vox-code, vox-sonnet, vox-sol, vox-luna e vox-vision.

Streaming

Envie "stream": true. A API usa SSE e encerra com [DONE].

Imagens

Rotas com visão recebem a imagem diretamente; em text-only o Multimodal prepara contexto visual.

Ferramentas

Quando a rota declara tool calling, o campo tools segue no formato Chat Completions.

Listar modelos

curl https://vox-40v.pages.dev/v1/models \
  -H "Authorization: Bearer sk_vox_SUA_CHAVE"

A lista é filtrada pela própria key. Chaves promocionais não recebem rotas premium bloqueadas para o plano.

Tokens e uso

GET /v1/usage?period=day
GET /v1/usage?period=month
GET /v1/usage?period=all

As respostas incluem uso de tokens e métricas básicas. Diagnósticos de rota e provedor ficam restritos ao Admin.

Segurança

Nunca coloque sua key VOX em JavaScript público. Provider secrets internos ficam no ambiente Cloudflare e não são enviados ao navegador.

Erros HTTP

401

Key ou sessão inválida.

402

Saldo/quota insuficiente.

403

Modelo fora do plano ou scope.

429

Rate limit.

503

Nenhuma rota elegível disponível.