API e desenvolvedores

API da VOX: gere apps e documentos nos seus sistemas

Crie uma chave e chame a VOX do seu código em 5 minutos — você escolhe o modelo e paga um preço previsível por chamada.

A API da VOX coloca a capacidade de criação da plataforma dentro do seu produto: você envia uma instrução e recebe o resultado pronto — um app (HTML publicável) ou um documento. Funciona como as APIs que você já conhece: autenticação por chave, você escolhe o modelo e paga por uso, com cobrança previsível em tokens da sua conta.

1. Crie sua chave

Abra o Console em voxcode.io/console e vá em "Chaves de API".
Dê um nome à chave (ex.: "site da loja") e clique em Criar chave.
Copie o segredo na hora — ele começa com vk_live_ e só aparece uma vez.
Pode revogar uma chave a qualquer momento; sistemas que a usam param de funcionar na hora.

O segredo da chave aparece UMA única vez na criação. Guarde em local seguro (variável de ambiente do seu servidor). Se perder, revogue e crie outra.

2. Escolha um modelo

Cada chamada roda no modelo VOX que você indicar no campo "model". Se você não enviar nenhum, usamos o VOX Pulsar (equilíbrio entre qualidade e custo). O preço é fixo e previsível por chamada — você sabe quanto vai pagar antes de chamar.

Modelo	Quando usar	create_app	document
vox-nova	Rápido e econômico — tarefas simples	4 tokens	2 tokens
vox-pulsar	Padrão — qualidade para o dia a dia	12 tokens	6 tokens
vox-quasar	Alta capacidade — apps elaborados	25 tokens	14 tokens
vox-vortex	Máxima capacidade e raciocínio	30 tokens	18 tokens

3. Faça a primeira chamada

Envie um POST para /api/v1/generate com a chave no cabeçalho Authorization e, no corpo, a ação, o modelo e o prompt. Em curl:

curl https://voxcode.io/api/v1/generate \
  -H "Authorization: Bearer vk_live_sua_chave" \
  -H "Content-Type: application/json" \
  -d '{
    "action": "create_app",
    "model": "vox-pulsar",
    "prompt": "loja de roupas com catálogo e botão de PIX"
  }'

Em JavaScript (Node) — sempre no back-end, nunca no navegador:

const res = await fetch("https://voxcode.io/api/v1/generate", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.VOX_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    action: "create_app",
    model: "vox-pulsar",
    prompt: "loja de roupas com catálogo e botão de PIX",
  }),
});
const data = await res.json();
console.log(data.app.html); // HTML pronto para publicar

Em Python:

import os, requests

res = requests.post(
    "https://voxcode.io/api/v1/generate",
    headers={"Authorization": f"Bearer {os.environ['VOX_API_KEY']}"},
    json={
        "action": "create_app",
        "model": "vox-pulsar",
        "prompt": "loja de roupas com catálogo e botão de PIX",
    },
)
data = res.json()
print(data["app"]["html"])  # HTML pronto para publicar

Ações disponíveis

Ação	O que faz	Retorna
create_app	Cria um site/app completo a partir do seu pedido	app.html (documento HTML pronto para publicar) + app.title
document	Escreve um documento pronto (proposta, contrato, texto…)	document.markdown

O que volta

A resposta é um JSON com o resultado, o modelo usado e o consumo daquela chamada. Exemplo para create_app:

{
  "id": "vox_d5676bf0eefbb5e0",
  "action": "create_app",
  "model": "vox-pulsar",
  "app": {
    "title": "Moda Chic - Loja de Roupas",
    "html": "<!DOCTYPE html> … </html>"
  },
  "usage": {
    "model": "vox-pulsar",
    "credits_charged": 12,
    "credits_remaining": 49760
  }
}

Cobrança e limites

O preço é o da tabela de modelos acima — fixo e previsível por chamada.
O consumo é debitado dos tokens da SUA conta VOX (o mesmo saldo do plano/recarga).
Sem tokens? A chamada retorna 402 — basta recarregar no Console para voltar a funcionar.
Limite de 60 chamadas por minuto por chave.

Erros

HTTP	Código	O que significa
401	invalid_key	Chave ausente, inválida ou revogada
402	insufficient_credits	Sua conta está sem tokens — adicione fundos
400	invalid_request	Faltou a ação/prompt, o modelo é inválido, ou o corpo é inválido
429	rate_limited	Passou de 60 chamadas/minuto nessa chave

Segurança: a chave vk_live_ dá acesso aos seus tokens. Use-a sempre no SEU servidor (back-end) — nunca no código que roda no navegador do visitante.