Introdução

​

Autenticação

Authorization: Bearer VENICE_API_KEY

​

Compatibilidade com OpenAI

​

Configuração

curl https://api.venice.ai/api/v1/chat/completions \
  -H "Authorization: Bearer $VENICE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "venice-uncensored",
    "messages": [{"role": "user", "content": "Hello!"}]
  }'

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: process.env.VENICE_API_KEY,
  baseURL: "https://api.venice.ai/api/v1",
});

const response = await client.chat.completions.create({
  model: "venice-uncensored",
  messages: [{ role: "user", content: "Hello!" }]
});

console.log(response.choices[0].message.content);

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ.get("VENICE_API_KEY"),
    base_url="https://api.venice.ai/api/v1"
)

response = client.chat.completions.create(
    model="venice-uncensored",
    messages=[{"role": "user", "content": "Hello!"}]
)

print(response.choices[0].message.content)

​

Recursos específicos da Venice

​

Prompts de sistema

1. Comportamento padrão: Seus prompts de sistema são acrescentados aos padrões da Venice
2. Comportamento personalizado: Desabilite completamente os prompts de sistema da Venice

​

Desabilitando os prompts de sistema da Venice

curl https://api.venice.ai/api/v1/chat/completions \
  -H "Authorization: Bearer $VENICE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "venice-uncensored",
    "messages": [
      {"role": "system", "content": "Your custom system prompt"},
      {"role": "user", "content": "Why is the sky blue?"}
    ],
    "venice_parameters": {
      "include_venice_system_prompt": false
    }
  }'

const completion = await client.chat.completions.create({
  model: "venice-uncensored",
  messages: [
    {
      role: "system",
      content: "Your custom system prompt",
    },
    {
      role: "user",
      content: "Why is the sky blue?",
    },
  ],
  venice_parameters: {
    include_venice_system_prompt: false,
  },
});

response = client.chat.completions.create(
    model="venice-uncensored",
    messages=[
        {"role": "system", "content": "Your custom system prompt"},
        {"role": "user", "content": "Why is the sky blue?"}
    ],
    extra_body={
        "venice_parameters": {
            "include_venice_system_prompt": False
        }
    }
)

​

Parâmetros da Venice

​

Prompt caching

​

Referência de cabeçalhos de resposta

​

Notas importantes

• Capitalização do nome do cabeçalho: Os cabeçalhos HTTP são case-insensitive, mas a Venice usa minúsculas com hífens para consistência
• Valores em string: Valores booleanos em cabeçalhos são retornados como strings ("true" ou "false")
• Valores numéricos: Números grandes e valores de saldo podem ser retornados como strings para evitar perda de precisão
• Cabeçalhos opcionais: Nem todos os cabeçalhos são retornados em todas as respostas; a presença depende do endpoint e do contexto da requisição
• Compactação: Use Accept-Encoding: gzip, br nas requisições para receber respostas compactadas quando suportado

​

Exemplo: Acessando cabeçalhos de resposta

// Após fazer uma requisição à API, acesse os cabeçalhos a partir do objeto de resposta
const requestId = response.headers.get('CF-RAY');
const remainingRequests = response.headers.get('x-ratelimit-remaining-requests');
const remainingTokens = response.headers.get('x-ratelimit-remaining-tokens');
const usdBalance = response.headers.get('x-venice-balance-usd');

// Verifique se há avisos de descontinuação de modelo
const deprecationWarning = response.headers.get('x-venice-model-deprecation-warning');
if (deprecationWarning) {
  console.warn(`Model Deprecation: ${deprecationWarning}`);
}

​

Melhores práticas

1. Limite de taxa: Monitore os cabeçalhos x-ratelimit-remaining-requests e x-ratelimit-remaining-tokens e implemente backoff exponencial
2. Monitoramento de saldo: Acompanhe os cabeçalhos x-venice-balance-usd e x-venice-balance-diem para evitar interrupções de serviço
3. Prompts de sistema: Teste com e sem os prompts de sistema da Venice para encontrar o melhor ajuste para seu caso de uso
4. Chaves de API: Mantenha suas chaves de API seguras e faça rotação regularmente
5. Registro de requisições: Registre os valores do cabeçalho CF-RAY para solucionar problemas com o suporte
6. Descontinuação de modelos: Verifique os cabeçalhos x-venice-model-deprecation-warning ao usar modelos

​

Diferenças em relação à API da OpenAI

1. venice_parameters: Configurações adicionais como enable_web_search, character_slug e strip_thinking_response para funcionalidade estendida
2. Prompts de sistema: A Venice acrescenta seus prompts de sistema a padrões otimizados para respostas sem censura (desabilite com include_venice_system_prompt: false)
3. Ecossistema de modelos: A Venice oferece sua própria linha de modelos incluindo modelos sem censura e de raciocínio — use os IDs de modelo da Venice em vez dos mapeamentos da OpenAI
4. Cabeçalhos de resposta: Cabeçalhos exclusivos para rastreamento de saldo (x-venice-balance-usd, x-venice-balance-diem), avisos de descontinuação de modelos e flags de segurança de conteúdo
5. Políticas de conteúdo: Políticas mais permissivas com modelos dedicados sem censura e filtragem de conteúdo opcional

​

Estabilidade da API

​

Especificação OpenAPI e dados brutos

• Especificação OpenAPI (YAML) — a especificação completa da API em formato YAML
• Fonte da documentação da API — todas as páginas de documentação (formato .mdx) como um arquivo para download