API Venice AI: primeira requisição em cinco minutos
Faça seu LLM sem censura funcionar em menos de cinco minutos com este guia rápido para a API Venice AI. Use os endpoints compatíveis com OpenAI para enviar texto, fazer streaming de respostas e chamar funções com preços transparentes de pagamento por uso.
https://api.veniceapialternative.com/v1
URL Base e Autenticação
Comece criando uma conta na página Obter chave de API. Você só precisa de um e-mail e uma senha; nenhum cartão de crédito é necessário para receber o crédito de teste de $0,50 válido por sete dias. Sua chave de API é exibida imediatamente após o signup e pode ser regenerada a qualquer momento, o que revoga a chave antiga.
Use a URL base https://api.veniceapialternative.com/v1 com os SDKs oficiais da OpenAI ou qualquer cliente compatível com OpenAI. Defina sua chave de API como o token Bearer no cabeçalho Authorization. Este endpoint venice ai api substitui a URL base padrão da OpenAI na configuração do seu cliente.
Primeira Requisição
Envie uma solicitação simples de conclusão de chat para testar a conexão. O ID do modelo é sempre uncensored. Este modelo de pesos abertos roda em nossos servidores GPU e é ajustado para responder sem recusas de conteúdo para uso adulto lícito.
Substitua YOUR_API_KEY pela sua chave real. A resposta retorna texto com base no seu prompt.
curl https://api.veniceapialternative.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [{"role": "user", "content": "Write a blunt product review of a cheap VPN."}]
}'
Exemplo SDK Python
Instale a biblioteca Python da OpenAI e configure-a para usar nosso base URL. Isso permite que você aproveite bases de código existentes que esperam endpoints da OpenAI.
from openai import OpenAI
client = OpenAI(base_url="https://api.veniceapialternative.com/v1", api_key="YOUR_KEY")
resp = client.chat.completions.create(
model="uncensored",
messages=[{"role": "user", "content": "Summarise this thread without softening it."}],
)
print(resp.choices[0].message.content)
Exemplo SDK Node.js
Para ambientes Node.js, use o pacote openai. Inicialize o cliente com a URL base personalizada e sua chave de API. Isso garante que todas as requisições sejam roteadas pela infraestrutura venice ai api.
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.veniceapialternative.com/v1", apiKey: process.env.API_KEY });
const resp = await client.chat.completions.create({
model: "uncensored",
messages: [{ role: "user", content: "Draft a villain monologue for my game." }],
});
console.log(resp.choices[0].message.content);
Respostas em Streaming
Ative o streaming definindo stream: true na sua requisição. A API retorna Server-Sent Events (SSE) para entrega de tokens em tempo real. Isso é útil para interfaces de chat que precisam exibir texto conforme é gerado.
stream = client.chat.completions.create(
model="uncensored",
messages=[{"role": "user", "content": "Tell the story in second person."}],
stream=True,
)
for chunk in stream:
if chunk.choices and chunk.choices[0].delta.content:
print(chunk.choices[0].delta.content, end="", flush=True)
Limites de Requisição e Restrições
O modelo uncensored suporta uma janela de contexto de 100.000 tokens para prompt e conclusão combinados. Você está limitado a 300 requisições por minuto por chave de API. Os corpos das requisições não devem exceder 8 MB.
Erros comuns incluem 401 (chave inválida), 402 (crédito insuficiente) e 429 (limite de requisições excedido). Recarregue crédito pré-pago a partir de $10; os créditos nunca expiram. Sem assinatura mensal que bloqueie seu uso.
Ficha técnica da API
Uma tabela com cada limite, recurso e preço.
| Item | Valor |
|---|---|
| Formato | compatível com OpenAI: qualquer SDK da OpenAI funciona trocando a base URL e a chave |
| Endpoints | POST /v1/chat/completions · GET /v1/models |
| ID do modelo | uncensored |
| Autenticação | Authorization: Bearer YOUR_KEY |
| Base URL | https://api.veniceapialternative.com/v1 |
| Modo JSON | response_format: {"type": "json_object"} |
| Parâmetros | temperature, top_p, stop, seed, presence_penalty, frequency_penalty |
| Janela de contexto | 100.000 tokens (entrada + saída) |
| Chamada de funções | sim — tools, tool_choice; resposta com tool_calls, inclusive em streaming; resultados como role: tool |
| Streaming | sim — server-sent events; o último bloco traz o uso de tokens |
| Saída máxima | até o restante da janela de 100.000 tokens; max_tokens opcional (sem limite separado) |
| Tamanho | até 8 MB por requisição |
| Concorrência | 8 requisições ao mesmo tempo por chave |
| Cabeçalhos | X-Request-Id, X-Balance-USD, X-RateLimit-Limit-Requests, X-RateLimit-Limit-Concurrency |
| Limite de taxa | 300 requisições por minuto por chave |
| Validade | crédito pago não expira, sem assinatura |
| Cobrança | crédito pré-pago pelo uso real; erros e recusas são grátis |
| Bônus | +5% a partir de $50, +10% a partir de $100 |
| Preço | $0,25 por 1M tokens de entrada · $1,00 por 1M de saída |
| Recarga | USDT (TRC20) ou USDC (Base), qualquer valor inteiro de $10 a $500 |
| Teste grátis | $0,50 por 7 dias, sem cartão · Chave de teste: 2 requisições paralelas, 60 por minuto; limites totais (8 e 300) após a primeira recarga |
| Chaves | uma chave ativa por conta; uma nova substitui a anterior |
| Login | Google ou e-mail e senha |
| Conteúdo | conteúdo adulto permitido; conteúdo sexual com menores é recusado |
Códigos de erro
Erros chegam em JSON com um type fixo; requisições com falha ou recusadas não são cobradas.
| Código | Tipo | Significado |
|---|---|---|
400 | bad_request | JSON inválido, mensagens vazias, parâmetro errado ou contexto longo demais |
401 | missing_key · invalid_key · key_revoked | chave ausente, errada ou substituída |
402 | no_credit | sem crédito — recarregue e continue na hora |
403 | content_blocked | conteúdo sexual com menores — recusado, sem cobrança |
404 | not_found | endpoint desconhecido |
413 | request_too_large | corpo acima de 8 MB |
429 | rate_limited · concurrency | acima de 300/min ou 8 em paralelo — aguarde e tente de novo |
503 | upstream_busy | modelo ocupado — tente em alguns segundos |
Perguntas e respostas
Esta é a API oficial Venice.ai?
Não. Este é um serviço independente que hospeda um modelo de pesos abertos sem censura. Não possui afiliação nem é revendedor da plataforma principal Venice.ai ou dos modelos de outros fornecedores.
Esta API suporta geração de imagens ou áudio?
Não. Esta é uma API de conclusão de chat apenas de texto. Ela não suporta embeddings, geração de imagens, áudio, vídeo ou fine-tuning.
O que acontece se meu crédito de teste grátis expirar?
Seu crédito de teste grátis expira após sete dias. Você pode recarregar com criptomoeda (USDT ou USDC) a partir de $10. Créditos pré-pagos nunca expiram, e você pode regenerar sua chave de API a qualquer momento.
Sua chave está a um formulário de distância
Crie uma conta, copie a chave, altere a URL base. Essa é toda a configuração.