> ## Documentation Index
> Fetch the complete documentation index at: https://veniceai-docs-revamp.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Migrare da OpenAI

> Passa da OpenAI a Venice AI in pochi minuti — stesso SDK, più privacy, senza restrizioni

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

## La migrazione in 2 righe

### Python

```python theme={"dark"}
# 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
)
```

### Node.js

```javascript theme={"dark"}
// 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',
});
```

### cURL

```bash theme={"dark"}
# Prima
curl https://api.openai.com/v1/chat/completions ...

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

### Variabili d'ambiente

```bash theme={"dark"}
# 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
```

<Tip>
  Molte librerie e strumenti leggono automaticamente `OPENAI_API_KEY` e `OPENAI_BASE_URL`. Aggiornare solo queste variabili d'ambiente potrebbe essere tutto ciò di cui hai bisogno.
</Tip>

## Mappatura dei modelli

| Modello OpenAI         | Equivalente Venice                            | Tipo       | Prezzo (Input/Output per 1M) |
| ---------------------- | --------------------------------------------- | ---------- | ---------------------------- |
| gpt-4o                 | `zai-org-glm-4.7` (Private)                   | Text       | $0.55 / $2.65                |
| gpt-4o                 | `openai-gpt-52` (Anonymized)                  | Text       | $2.19 / $17.50               |
| gpt-4o-mini            | `qwen3-4b`                                    | Text       | $0.05 / $0.15                |
| gpt-4-turbo            | `mistral-31-24b`                              | Text       | $0.50 / $2.00                |
| o1 / o3                | `qwen3-235b-a22b-thinking-2507` (Private)     | Reasoning  | $0.45 / $3.50                |
| o1 / o3                | `grok-41-fast` (Anonymized)                   | Reasoning  | $0.50 / $1.25                |
| gpt-4-vision           | `mistral-31-24b` o `qwen3-vl-235b-a22b`       | Vision     | $0.50 / $2.00                |
| text-embedding-3-small | `text-embedding-bge-m3`                       | Embeddings | $0.15 / $0.60                |
| dall-e-3               | `qwen-image` (Private, \$0.01) o `flux-2-pro` | Image      | Da \$0.01                    |
| whisper                | `nvidia/parakeet-tdt-0.6b-v3`                 | STT        | \$0.0001/sec                 |
| tts-1                  | `tts-kokoro`                                  | TTS        | \$3.50/1M chars              |

## Compatibilità delle funzionalità

| Funzionalità      | OpenAI | Venice | Note                                                   |
| ----------------- | ------ | ------ | ------------------------------------------------------ |
| Chat Completions  | ✅      | ✅      | Completamente compatibile                              |
| Streaming         | ✅      | ✅      | Formato SSE identico                                   |
| Function Calling  | ✅      | ✅      | Stesso parametro `tools`                               |
| Structured Output | ✅      | ✅      | Stesso `response_format`                               |
| Vision            | ✅      | ✅      | Stesso formato dell'array di contenuto                 |
| Embeddings        | ✅      | ✅      | Stessa API                                             |
| Image Generation  | ✅      | ✅      | Compatibile con OpenAI tramite `/images/generations`\* |
| TTS               | ✅      | ✅      | Compatibile                                            |
| STT               | ✅      | ✅      | Compatibile                                            |
| Assistants API    | ✅      | ❌      | Usa invece Characters o Minds                          |
| Batch API         | ✅      | ❌      | Non ancora disponibile                                 |
| Fine-tuning       | ✅      | ❌      | Non disponibile                                        |

\*Venice fornisce anche un endpoint compatibile con OpenAI in `POST /images/generations` per una migrazione più facile da DALL-E. Per l'API immagini nativa di Venice con opzioni aggiuntive, consulta [Image Generate](/api-reference/endpoint/image/generate).

## Funzionalità solo di Venice

Venice offre capacità che OpenAI non ha:

### 1. Web search integrata

```python theme={"dark"}
response = client.chat.completions.create(
    model="venice-uncensored",
    messages=[{"role": "user", "content": "Latest AI news today"}],
    extra_body={
        "venice_parameters": {
            "enable_web_search": "auto"
        }
    }
)
```

### 2. Web scraping

```python theme={"dark"}
response = client.chat.completions.create(
    model="venice-uncensored",
    messages=[{"role": "user", "content": "Summarize https://example.com/article"}],
    extra_body={
        "venice_parameters": {
            "enable_web_scraping": True
        }
    }
)
```

### 3. Personaggi (Persona AI)

```python theme={"dark"}
response = client.chat.completions.create(
    model="venice-uncensored",
    messages=[{"role": "user", "content": "Tell me about yourself"}],
    extra_body={
        "venice_parameters": {
            "character_slug": "venice-ai"
        }
    }
)
```

### 4. Modelli senza restrizioni

I modelli privati di Venice non hanno filtri sui contenuti, rendendoli adatti a:

* Scrittura creativa senza guardrail
* Ricerca di sicurezza e red teaming
* Analisi onesta senza pattern di rifiuto
* Informazioni mediche/legali senza disclaimer

### 5. Generazione video

```python theme={"dark"}
# Metti in coda un job di generazione video
import requests

response = requests.post(
    "https://api.venice.ai/api/v1/video/queue",
    headers={"Authorization": f"Bearer {api_key}", "Content-Type": "application/json"},
    json={
        "model": "wan-2.6-text-to-video",
        "prompt": "A serene lake at sunset with gentle waves",
        "resolution": "720p",
        "duration": 5,
    }
)
job_id = response.json()["id"]
```

## Perché migrare?

### Privacy

* **Zero data retention** sui modelli privati — i tuoi prompt non vengono mai memorizzati
* **Nessun training sui tuoi dati** — mai
* OpenAI conserva i dati per 30 giorni e può usarli per ricerca sulla sicurezza

### Costo

* I modelli privati sono **spesso più economici** degli equivalenti OpenAI
* `qwen3-4b` a \$0,05/1M input è 10× più economico di gpt-4o-mini
* `venice-uncensored` a $0,20/1M input contro gpt-4o a $2,50/1M

### Libertà

* **Nessun filtro sui contenuti** sui modelli senza restrizioni
* Nessuna sospensione di account per casi d'uso controversi
* Nativo Web3 con opzioni di pagamento crypto
* Staking DIEM per crediti giornalieri

### Diversità dei modelli

* Accesso a modelli di più provider (Qwen, Llama, Mistral, Gemma, Claude, GPT, Grok, ecc.)
* Passa tra modelli privati e anonimizzati per richiesta
* Nuovi modelli aggiunti regolarmente

## Migrazione dei framework

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

| Framework     | Modifica richiesta                             |
| ------------- | ---------------------------------------------- |
| LangChain     | `base_url` in `ChatOpenAI`                     |
| Vercel AI SDK | `baseURL` in `createOpenAI`                    |
| CrewAI        | variabile d'ambiente `OPENAI_API_BASE`         |
| LlamaIndex    | `api_base` in `OpenAI`                         |
| AutoGen       | `base_url` nella configurazione                |
| Haystack      | `api_base_url` in `OpenAIGenerator`            |
| Claude Code   | flag `--api-base` o variabile d'ambiente       |
| Cursor        | endpoint API personalizzato nelle impostazioni |
| Continue.dev  | `apiBase` in config.json                       |

<Card title="Ottieni la tua API key" icon="key" href="https://venice.ai/settings/api">
  Genera una API key Venice e inizia a migrare in pochi minuti
</Card>