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

> ## Agent Instructions
> The Venice API is OpenAI-compatible: use any OpenAI SDK with the base URL `https://api.venice.ai/api/v1` and a Venice API key, or pay per request from a USDC wallet through x402 with no account.
> Read model IDs from `GET /models` or `GET /models/traits` at runtime instead of hardcoding them from memory or from these pages. Models are added and retired often.
> Every model's price is in https://docs.venice.ai/pricing.md. Quote video and audio jobs with `POST /video/quote` or `POST /audio/quote` before you queue them.
> Search these docs from an MCP client at https://docs.venice.ai/mcp. The full agent guide is https://docs.venice.ai/agents.md.

# Cursor IDE

> Configura Cursor IDE per usare i modelli Venice come Claude, GPT e DeepSeek tramite una base URL compatibile OpenAI con prezzi pay-per-token.

[Cursor](https://www.cursor.com/) è un editor di codice basato su AI. Puoi usarlo con Venice AI per un accesso privato e senza restrizioni a un'ampia gamma di modelli.

> [card] Paga per token
>
> Nessun abbonamento. Paghi solo per ciò che usi

> [card] Tutti i modelli
>
> Accedi a Claude, GPT, DeepSeek, Llama e altri

> [card] Compatibile con OpenAI
>
> Funziona tramite l'API compatibile con OpenAI di Venice

***

## Configurazione

**1. Ottieni la tua API key**

Genera una chiave da [venice.ai/settings/api](https://venice.ai/settings/api?utm_source=venice-api-documentation).

**2. Configura Cursor**

Apri **Cursor Settings** (icona dell'ingranaggio), scorri fino a **Models** e clicca su **Add Model**.

Sotto **OpenAI Compatible**, inserisci:

* **Override OpenAI Base URL**: `https://api.venice.ai/api/v1`
* **OpenAI API Key**: la tua API key Venice

**3. Aggiungi modelli**

Nel campo del nome modello, digita l'ID del modello Venice e premi Invio. Aggiungi ciascun modello che vuoi usare. Ad esempio:

* `minimax-m25`
* `kimi-k2-5`
* `venice-claude-opus-4-6` (vedi la [nota sul prefisso più sotto](#il-prefisso-di-modello-venice-))

Consulta il [catalogo modelli](https://docs.venice.ai/models/text.md) per tutti gli ID dei modelli disponibili.

**4. Seleziona e verifica**

Apri una nuova chat e usa il **selettore di modello in fondo alla chat** per scegliere uno dei modelli Venice appena aggiunti. Invia un messaggio di prova. Se ricevi una risposta, è tutto pronto.

***

## Il prefisso di modello `venice-`

> [!WARNING]
>
> **I modelli Claude richiedono il prefisso `venice-` quando vengono usati in Cursor.**
>
> Cursor riscrive le richieste per i modelli `claude-*` nel formato nativo di Anthropic, che è incompatibile con Venice. Anteporre il prefisso `venice-` all'ID del modello impedisce questa riscrittura. Venice rimuove automaticamente il prefisso.

| Modello | ID standard | ID Cursor |
| - | - | - |
| Claude Opus 4.6 | `claude-opus-4-6` | `venice-claude-opus-4-6` |
| Claude Opus 4.6 Fast | `claude-opus-4-6-fast` | `venice-claude-opus-4-6-fast` |
| Claude Sonnet 4.6 | `claude-sonnet-4-6` | `venice-claude-sonnet-4-6` |
| Claude Opus 4.5 | `claude-opus-4-5` | `venice-claude-opus-4-5` |

> [!NOTE]
>
> I modelli non Claude (ad es. `minimax-m25`, `kimi-k2-5`, `zai-org-glm-5`) **non sono interessati** e funzionano senza il prefisso. Il prefisso `venice-` è sicuro da usare su qualsiasi modello, dato che Venice lo rimuove sempre, ma è richiesto solo per i modelli Claude in Cursor.

***

## Risorse

> [card] [Documentazione API Venice](https://docs.venice.ai/api-reference/api-spec.md)
>
> Riferimento completo dell'API

> [card] [Catalogo modelli](https://docs.venice.ai/models/text.md)
>
> Sfoglia i modelli disponibili


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.