Migrare da OpenAI

Venice AI è un sostituto drop-in di OpenAI. Stesso SDK, stesso codice — basta cambiare due righe. Ottieni inferenza privacy-first, modelli non censurati e prezzi competitivi.

La migrazione in 2 righe

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

# Dopo (Venice) — cambia api_key e base_url
from openai import OpenAI
client = OpenAI(
    api_key="your-venice-api-key",           # ← Modifica 1
    base_url="https://api.venice.ai/api/v1",  # ← Modifica 2
)

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

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

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

# Dopo — basta cambiare la URL e la chiave
curl https://api.venice.ai/api/v1/chat/completions ...

Genera una chiave da venice.ai/settings/api oppure segui la guida alle API key.

Variabili d’ambiente

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

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

Molte librerie e strumenti leggono automaticamente OPENAI_API_KEY e OPENAI_BASE_URL. Aggiornare queste variabili d’ambiente potrebbe essere tutto ciò di cui hai bisogno. Alcuni strumenti usano ancora OPENAI_API_BASE per lo stesso URL.

Modelli

Passa un ID di modello Venice, un trait come default o most_uncensored, oppure un nome familiare in stile OpenAI. Venice mappa i nomi OpenAI tramite il compatibility mapping. I trait si risolvono sempre al modello corrente per quel ruolo — vedi model traits. Sfoglia il catalogo aggiornato su Modelli di testo e Prezzi. Per un walkthrough della prima richiesta, consulta la Quickstart.

Compatibilità delle funzionalità

Funzionalità	OpenAI	Venice	Note
Chat Completions	✅	✅	Pienamente compatibile
Streaming	✅	✅	Stesso formato SSE
Function Calling	✅	✅	Stesso parametro `tools`
Structured Output	✅	✅	Stesso `response_format`
Vision	✅	✅	Stesso formato per l’array content
Embeddings	✅	✅	Stessa API
Generazione di immagini	✅	✅	OpenAI-compatible tramite `/images/generations`
TTS	✅	✅	Compatibile
STT	✅	✅	Compatibile
Responses API	✅	✅	Alpha
Assistants API	✅	❌	Usa i Characters o il function calling
Batch API	✅	❌	Non ancora disponibile
Fine-tuning	✅	❌	Non disponibile

Per le opzioni native sulle immagini oltre l’endpoint OpenAI-compatible, consulta Generazione di immagini.

Funzionalità esclusive di Venice

Passa opzioni specifiche di Venice attraverso extra_body come venice_parameters. La ricerca web integrata è di solito il primo extra:

response = client.chat.completions.create(
    model="default",
    messages=[{"role": "user", "content": "Ultime notizie di AI oggi"}],
    extra_body={
        "venice_parameters": {
            "enable_web_search": "auto"
        }
    },
)

Lo stesso pattern copre web scraping, citazioni e Characters. Se un client non può modificare il body della richiesta, aggiungi un suffisso di feature del modello come default:enable_web_search=auto. Venice offre inoltre API native per video, musica, recupero dal web e x402, affiancate alla superficie OpenAI-compatible.

Framework

La maggior parte dei framework AI funziona con Venice cambiando la base URL:

LangChain

base_url in ChatOpenAI

Vercel AI SDK

baseURL in createOpenAI

LlamaIndex

api_base sul client OpenAI-compatible

CrewAI

Variabile d’ambiente OPENAI_API_BASE

PydanticAI

Modello OpenAI-compatible con base URL di Venice

Cursor

Endpoint API personalizzato nelle impostazioni

Claude Code

Instrada Claude Code attraverso Venice

Codex CLI

Provider del modello in config.toml

Aider

Variabile d’ambiente OPENAI_API_BASE

Altri agenti di coding e strumenti sono elencati in AI Agents.

Modelli non censurati

I modelli privati non censurati di Venice non applicano filtri sui contenuti, il che li rende adatti a:

Scrittura creativa senza guardrail
Ricerca sulla sicurezza e red teaming
Analisi oneste senza pattern di rifiuto
Informazioni mediche e legali senza disclaimer aggiuntivi

Usa il trait most_uncensored oppure un ID di modello non censurato attuale da Modelli di testo.

Ottieni la tua API Key

Genera una API key di Venice e inizia la migrazione in pochi minuti

Documentazione

Per iniziare

Testo e chat

Immagini, video e audio

Ricerca e RAG

Agenti e integrazioni

Strumenti di sviluppo

Strumenti per agenti

SDK e framework

La migrazione in 2 righe

Variabili d’ambiente

Modelli

Compatibilità delle funzionalità

Funzionalità esclusive di Venice

Framework

LangChain

Vercel AI SDK

LlamaIndex

CrewAI

PydanticAI

Cursor

Claude Code

Codex CLI

Aider

Modelli non censurati

Ottieni la tua API Key

​La migrazione in 2 righe

​Variabili d’ambiente

​Modelli

​Compatibilità delle funzionalità

​Funzionalità esclusive di Venice

​Framework

LangChain

Vercel AI SDK

LlamaIndex

CrewAI

PydanticAI

Cursor

Claude Code

Codex CLI

Aider

​Modelli non censurati

Ottieni la tua API Key

La migrazione in 2 righe

Variabili d’ambiente

Modelli

Compatibilità delle funzionalità

Funzionalità esclusive di Venice

Framework

Modelli non censurati