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

# Migrare da OpenAI

> Sposta le app OpenAI-compatible di chat, embeddings e immagini su Venice in pochi minuti cambiando la base URL e la API key — stesso SDK, più privacy.

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

<CodeGroup>
  ```python Python theme={null}
  # 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
  )
  ```

  ```javascript Node.js theme={null}
  // 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",
  });
  ```

  ```bash cURL theme={null}
  # 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 ...
  ```
</CodeGroup>

Genera una chiave da [venice.ai/settings/api](https://venice.ai/settings/api?utm_source=venice-api-documentation) oppure segui la [guida alle API key](/guides/getting-started/generating-api-key).

### Variabili d'ambiente

```bash theme={null}
# 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 queste variabili d'ambiente potrebbe essere tutto ciò di cui hai bisogno. Alcuni strumenti usano ancora `OPENAI_API_BASE` per lo stesso URL.
</Tip>

## 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](/api-reference/endpoint/models/compatibility_mapping). I trait si risolvono sempre al modello corrente per quel ruolo — vedi [model traits](/api-reference/endpoint/models/traits).

Sfoglia il catalogo aggiornato su [Modelli di testo](/models/text) e [Prezzi](/overview/pricing). Per un walkthrough della prima richiesta, consulta la [Quickstart](/getting-started/quick-start).

## 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              | ✅      | ✅      | Solo testo; gli array di token restituiscono HTTP 400                                                      |
| Generazione di immagini | ✅      | ✅      | OpenAI-compatible tramite `/images/generations`                                                            |
| TTS                     | ✅      | ✅      | Compatibile                                                                                                |
| STT                     | ✅      | ✅      | Compatibile                                                                                                |
| Responses API           | ✅      | ✅      | Alpha                                                                                                      |
| Assistants API          | ✅      | ❌      | Usa i [Characters](/guides/features/characters) o il [function calling](/guides/features/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](/guides/media/image-generation).

## Funzionalità esclusive di Venice

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

```python theme={null}
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](/guides/features/characters). Se un client non può modificare il body della richiesta, aggiungi un [suffisso di feature del modello](/api-reference/endpoint/chat/model_feature_suffix) come `default:enable_web_search=auto`.

Venice offre inoltre API native per [video](/guides/media/video-generation), [musica](/guides/media/music-and-sound-effects), [recupero dal web](/guides/tools/web-retrieval) e [x402](/guides/integrations/x402-venice-api), affiancate alla superficie OpenAI-compatible.

## Framework

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

<CardGroup cols={3}>
  <Card title="LangChain" icon="link" href="/guides/integrations/langchain">
    `base_url` in `ChatOpenAI`; `check_embedding_ctx_length=False` su `OpenAIEmbeddings`
  </Card>

  <Card title="Vercel AI SDK" icon="link" href="/guides/integrations/vercel-ai-sdk">
    `baseURL` in `createOpenAI`
  </Card>

  <Card title="LlamaIndex" icon="link" href="/guides/integrations/llamaindex">
    `api_base` sul client OpenAI-compatible
  </Card>

  <Card title="CrewAI" icon="link" href="/guides/integrations/crewai">
    Variabile d'ambiente `OPENAI_API_BASE`
  </Card>

  <Card title="PydanticAI" icon="link" href="/guides/integrations/pydanticai">
    Modello OpenAI-compatible con base URL di Venice
  </Card>

  <Card title="Cursor" icon="link" href="/guides/integrations/cursor">
    Endpoint API personalizzato nelle impostazioni
  </Card>

  <Card title="Claude Code" icon="link" href="/guides/integrations/claude-code">
    Instrada Claude Code attraverso Venice
  </Card>

  <Card title="Codex CLI" icon="link" href="/guides/integrations/codex-cli">
    Provider del modello in `config.toml`
  </Card>

  <Card title="Aider" icon="link" href="/guides/integrations/aider">
    Variabile d'ambiente `OPENAI_API_BASE`
  </Card>
</CardGroup>

Altri agenti di coding e strumenti sono elencati in [AI Agents](/guides/integrations/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](/models/text).

<Card title="Ottieni la tua API Key" icon="key" href="https://venice.ai/settings/api?utm_source=venice-api-documentation">
  Genera una API key di Venice e inizia la migrazione in pochi minuti
</Card>