Migre da OpenAI

A Venice AI é uma substituição direta da OpenAI. Mesmo SDK, mesmo código — basta alterar duas linhas. Tenha inferência com foco em privacidade, modelos sem censura e preços competitivos.

A migração em 2 linhas

# Antes (OpenAI)
from openai import OpenAI
client = OpenAI()

# Depois (Venice) — altere api_key e base_url
from openai import OpenAI
client = OpenAI(
    api_key="your-venice-api-key",           # ← Alteração 1
    base_url="https://api.venice.ai/api/v1",  # ← Alteração 2
)

// Antes (OpenAI)
import OpenAI from "openai";
const client = new OpenAI();

// Depois (Venice)
import OpenAI from "openai";
const client = new OpenAI({
  apiKey: "your-venice-api-key",
  baseURL: "https://api.venice.ai/api/v1",
});

# Antes
curl https://api.openai.com/v1/chat/completions ...

# Depois — basta alterar a URL e a chave
curl https://api.venice.ai/api/v1/chat/completions ...

Gere uma chave em venice.ai/settings/api ou siga o guia de chave de API.

Variáveis de ambiente

# Antes
OPENAI_API_KEY=sk-...
OPENAI_BASE_URL=https://api.openai.com/v1

# Depois
OPENAI_API_KEY=your-venice-api-key
OPENAI_BASE_URL=https://api.venice.ai/api/v1

Muitas bibliotecas e ferramentas leem OPENAI_API_KEY e OPENAI_BASE_URL automaticamente. Atualizar essas variáveis de ambiente pode ser tudo o que você precisa. Algumas ferramentas ainda usam OPENAI_API_BASE para a mesma URL.

Modelos

Passe um ID de modelo da Venice, um trait como default ou most_uncensored ou, para modelos de chat e de embedding, um nome familiar no estilo OpenAI. A Venice mapeia nomes de modelos de chat e de embedding da OpenAI por meio do mapeamento de compatibilidade; outros endpoints, incluindo os de áudio, exigem IDs de modelo da Venice. Traits sempre resolvem para o modelo atual daquele papel. Veja traits de modelo. Navegue pelo catálogo ao vivo em Modelos de texto e Preços. Para um passo a passo da primeira requisição, veja o Guia rápido.

Compatibilidade de recursos

Recurso	OpenAI	Venice	Observações
Chat Completions	✅	✅	Compatível. Campos de nível superior desconhecidos, incluindo os exclusivos da OpenAI como `logit_bias` e `service_tier`, retornam HTTP 400
Streaming	✅	✅	Mesmo formato SSE, mais um chunk final de uso; veja Formato de streaming
Function Calling	✅	✅	Mesmo parâmetro `tools`
Saída estruturada	✅	✅	Mesmo `response_format`
Visão	✅	✅	Mesmo formato de array de conteúdo
Embeddings	✅	✅	Apenas texto; arrays de tokens retornam HTTP 400
Geração de imagem	✅	✅	Compatível com OpenAI via `/images/generations`
Edição de imagem	✅	❌	Não há endpoint `/images/edits`. Use o endpoint nativo `/image/edit`
TTS	✅	✅	Formato de requisição compatível; use IDs de modelo da Venice (nomes de modelos de áudio da OpenAI retornam HTTP 400)
STT	✅	✅	Formato de requisição compatível; use IDs de modelo da Venice. `response_format` aceita apenas `json` ou `text`. Sem `/audio/translations`
Responses API	✅	✅	Nativo para modelos OpenAI, traduzido para os demais; veja as limitações
Assistants API	✅	❌	Use Characters ou function calling
Batch API	✅	❌	Ainda não disponível
Fine-tuning	✅	❌	Não disponível

Para opções nativas de imagem além do endpoint compatível com OpenAI, veja Geração de imagem.

Formato de streaming

Os streams de Chat Completions usam o formato de chunks da OpenAI e terminam com data: [DONE]. Dois detalhes são diferentes:

Chunk de uso. Todo stream termina com um chunk de uso antes de [DONE], mesmo quando stream_options.include_usage é false. Seu array choices fica vazio e ele traz usage e um objeto cost. Clientes que leem choices[0] em cada chunk devem ignorar chunks sem choices.
Erros depois que o stream começa. O status HTTP já é 200, então o erro chega como um evento data: com um objeto error (message, type, code), seguido de data: [DONE]. Quando o modelo está sobrecarregado, o objeto também inclui retry_after em segundos.

data: {"error":{"message":"...","type":"server_error","code":"...","param":null}}

data: [DONE]

Recursos exclusivos da Venice

Passe opções específicas da Venice através de extra_body como venice_parameters. A busca web integrada é normalmente o primeiro extra:

response = client.chat.completions.create(
    model="default",
    messages=[{"role": "user", "content": "Latest AI news today"}],
    extra_body={
        "venice_parameters": {
            "enable_web_search": "auto"
        }
    },
)

Chaves desconhecidas dentro de venice_parameters são ignoradas em vez de rejeitadas, então confira a grafia de cada chave na referência da API. O mesmo padrão vale para web scraping, citações e Characters. Se um cliente não puder alterar o corpo da requisição, adicione um sufixo de recurso do modelo como default:enable_web_search=auto. A Venice também tem APIs nativas de vídeo, música, busca web e x402 ao lado da superfície compatível com OpenAI.

Frameworks

A maioria dos frameworks de IA funciona com a Venice alterando a base URL:

LangChain

base_url em ChatOpenAI; check_embedding_ctx_length=False em OpenAIEmbeddings

Vercel AI SDK

baseURL em createOpenAI

LlamaIndex

api_base no cliente compatível com OpenAI

CrewAI

Variável de ambiente OPENAI_API_BASE

PydanticAI

Modelo compatível com OpenAI usando a base URL da Venice

Cursor

Endpoint de API personalizado nas configurações

Claude Code

Roteie o Claude Code pela Venice

Codex CLI

Provedor de modelo em config.toml

Aider

Variável de ambiente OPENAI_API_BASE

Mais agentes de programação e ferramentas estão listados em Agentes de IA.

Modelos sem censura

Os modelos privados sem censura da Venice não têm filtragem de conteúdo, o que os torna adequados para:

Escrita criativa sem barreiras
Pesquisa de segurança e red teaming
Análise honesta sem padrões de recusa
Informações médicas e jurídicas sem avisos extras

Use o trait most_uncensored ou um ID atual de modelo sem censura em Modelos de texto.

Obtenha sua chave de API

Gere uma chave de API Venice e comece a migrar em minutos

Documentação

Primeiros passos

Texto e chat

Imagem

Vídeo

Áudio

Pesquisa e RAG

Agentes e integrações

Ferramentas de código

Ferramentas para agentes

SDKs e frameworks

A migração em 2 linhas

Variáveis de ambiente

Modelos

Compatibilidade de recursos

Formato de streaming

Recursos exclusivos da Venice

Frameworks

LangChain

Vercel AI SDK

LlamaIndex

CrewAI

PydanticAI

Cursor

Claude Code

Codex CLI

Aider

Modelos sem censura

Obtenha sua chave de API

​A migração em 2 linhas

​Variáveis de ambiente

​Modelos

​Compatibilidade de recursos

​Formato de streaming

​Recursos exclusivos da Venice

​Frameworks

LangChain

Vercel AI SDK

LlamaIndex

CrewAI

PydanticAI

Cursor

Claude Code

Codex CLI

Aider

​Modelos sem censura

Obtenha sua chave de API

A migração em 2 linhas

Variáveis de ambiente

Modelos

Compatibilidade de recursos

Formato de streaming

Recursos exclusivos da Venice

Frameworks

Modelos sem censura