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, per i modelli di chat e di embedding, un nome familiare in stile OpenAI. Venice mappa i nomi dei modelli di chat e di embedding OpenAI tramite il compatibility mapping; gli altri endpoint, incluso quello audio, richiedono ID di modello Venice. 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	✅	✅	Compatibile. I campi di primo livello sconosciuti, inclusi quelli esclusivi di OpenAI come `logit_bias` e `service_tier`, restituiscono HTTP 400
Streaming	✅	✅	Stesso formato SSE, più un chunk finale di usage, vedi Formato dello streaming
Function Calling	✅	✅	Stesso parametro `tools`
Structured Output	✅	✅	Stesso `response_format`
Vision	✅	✅	Stesso formato per l’array content
Embeddings	✅	✅	Solo testo; gli array di token restituiscono HTTP 400
Generazione di immagini	✅	✅	OpenAI-compatible tramite `/images/generations`
Modifica di immagini	✅	❌	Nessun endpoint `/images/edits`. Usa l’endpoint nativo `/image/edit`
TTS	✅	✅	Struttura della richiesta compatibile; usa ID di modello Venice (i nomi dei modelli audio OpenAI restituiscono HTTP 400)
STT	✅	✅	Struttura della richiesta compatibile; usa ID di modello Venice. `response_format` accetta solo `json` o `text`. Nessun `/audio/translations`
Responses API	✅	✅	Beta. Nativa per i modelli OpenAI, tradotta per gli altri, vedi le limitazioni
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.

Formato dello streaming

Gli stream di Chat Completions usano il formato dei chunk di OpenAI e terminano con data: [DONE]. Due dettagli sono diversi:

Chunk di usage. Ogni stream termina con un chunk di usage prima di [DONE], anche quando stream_options.include_usage è false. Il suo array choices è vuoto e contiene usage e un oggetto cost. I client che leggono choices[0] su ogni chunk devono saltare i chunk senza choices.
Errori dopo l’avvio dello stream. Lo stato HTTP è già 200, quindi l’errore arriva come evento data: con un oggetto error (message, type, code), seguito da data: [DONE]. Quando il modello è sovraccarico, l’oggetto include anche retry_after in secondi.

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

data: [DONE]

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"
        }
    },
)

Le chiavi sconosciute all’interno di venice_parameters vengono ignorate anziché rifiutate, quindi verifica l’ortografia di ogni chiave nel riferimento API. 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; check_embedding_ctx_length=False su OpenAIEmbeddings

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

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à

Formato dello streaming

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à

​Formato dello streaming

​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à

Formato dello streaming

Funzionalità esclusive di Venice

Framework

Modelli non censurati