> ## 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.

# Guida rapida

> Guida rapida per la Venice API — genera una chiave API, invia il tuo primo chat completion ed esplora gli endpoint per immagini, video e audio in pochi minuti.

Inizia a usare la Venice API in pochi minuti. Genera una chiave API, effettua la tua prima richiesta e inizia a sviluppare.

## Guida rapida

<Steps>
  <Step title="Ottieni la tua chiave API">
    Vai alle [Impostazioni Venice API](https://venice.ai/settings/api) e genera una nuova chiave API.

    Per una guida dettagliata, consulta la [guida alle chiavi API](/guides/getting-started/generating-api-key).
  </Step>

  <Step title="Configura la tua chiave API">
    Aggiungi la tua chiave API all'ambiente. Puoi esportarla nella tua shell:

    ```bash theme={"system"}
    export VENICE_API_KEY='your-api-key-here'
    ```

    Oppure aggiungerla a un file `.env` nel tuo progetto:

    ```bash theme={"system"}
    VENICE_API_KEY=your-api-key-here
    ```
  </Step>

  <Step title="Installa l'SDK">
    Venice è compatibile con OpenAI, quindi puoi utilizzare l'SDK di OpenAI. Se preferisci usare cURL o richieste HTTP dirette, puoi saltare questo passaggio.

    <CodeGroup>
      ```bash Python theme={"system"}
      pip install openai
      ```

      ```bash Node.js theme={"system"}
      npm install openai
      ```
    </CodeGroup>
  </Step>

  <Step title="Invia la tua prima richiesta">
    <CodeGroup>
      ```python Python theme={"system"}
      import os
      from openai import OpenAI

      client = OpenAI(
          api_key=os.getenv("VENICE_API_KEY"),
          base_url="https://api.venice.ai/api/v1"
      )

      completion = client.chat.completions.create(
          model="zai-org-glm-5",
          messages=[
              {"role": "system", "content": "You are a helpful AI assistant"},
              {"role": "user", "content": "Why is privacy important?"}
          ]
      )

      print(completion.choices[0].message.content)
      ```

      ```javascript Node.js theme={"system"}
      import OpenAI from 'openai';

      const client = new OpenAI({
          apiKey: process.env.VENICE_API_KEY,
          baseURL: 'https://api.venice.ai/api/v1'
      });

      const completion = await client.chat.completions.create({
          model: 'zai-org-glm-5',
          messages: [
              { role: 'system', content: 'You are a helpful AI assistant' },
              { role: 'user', content: 'Why is privacy important?' }
          ]
      });

      console.log(completion.choices[0].message.content);
      ```

      ```bash cURL theme={"system"}
      curl https://api.venice.ai/api/v1/chat/completions \
        -H "Authorization: Bearer $VENICE_API_KEY" \
        -H "Content-Type: application/json" \
        -d '{
          "model": "zai-org-glm-5",
          "messages": [
            {"role": "system", "content": "You are a helpful AI assistant"},
            {"role": "user", "content": "Why is privacy important?"}
          ]
        }'
      ```
    </CodeGroup>

    **Ruoli dei messaggi:**

    * `system` - Istruzioni su come il modello deve comportarsi
    * `user` - I tuoi prompt o domande
    * `assistant` - Risposte precedenti del modello (per conversazioni a più turni)
    * `tool` - Risultati di chiamate a funzioni (quando si usano strumenti)
  </Step>

  <Step title="Cambia modello modificando l'ID del modello">
    Ogni richiesta include un ID `model`. Per usare un modello diverso, cambia il valore di `model` nella tua richiesta. Scelte popolari:

    * `zai-org-glm-5` - Modello predefinito per la maggior parte dei casi d'uso
    * `kimi-k2-6` - Ragionamento avanzato per compiti più complessi
    * `claude-opus-4-8` - Modello ad alta intelligenza per compiti complessi
    * `venice-uncensored-1-2` - Il modello senza censura di Venice

    <Card title="Visualizza tutti i modelli" icon="database" href="/overview/models">
      Sfoglia l'elenco completo dei modelli con prezzi, capacità e limiti di contesto
    </Card>
  </Step>

  <Step title="Utilizza i Venice Parameters">
    Puoi abilitare funzionalità specifiche di Venice come la ricerca web tramite `venice_parameters`:

    <CodeGroup>
      ```python Python theme={"system"}
      import os
      from openai import OpenAI

      client = OpenAI(
          api_key=os.environ.get("VENICE_API_KEY"),
          base_url="https://api.venice.ai/api/v1"
      )

      completion = client.chat.completions.create(
          model="zai-org-glm-5",
          messages=[
              {"role": "user", "content": "What are the latest developments in AI?"}
          ],
          extra_body={
              "venice_parameters": {
                  "enable_web_search": "auto",
                  "include_venice_system_prompt": True
              }
          }
      )

      print(completion.choices[0].message.content)
      ```

      ```javascript Node.js theme={"system"}
      import OpenAI from 'openai';

      const client = new OpenAI({
          apiKey: process.env.VENICE_API_KEY,
          baseURL: 'https://api.venice.ai/api/v1'
      });

      const completion = await client.chat.completions.create({
          model: 'zai-org-glm-5',
          messages: [
              { role: 'user', content: 'What are the latest developments in AI?' }
          ],
          venice_parameters: {
              enable_web_search: 'auto',
              include_venice_system_prompt: true
          }
      });

      console.log(completion.choices[0].message.content);
      ```

      ```bash cURL theme={"system"}
      curl https://api.venice.ai/api/v1/chat/completions \
        -H "Authorization: Bearer $VENICE_API_KEY" \
        -H "Content-Type: application/json" \
        -d '{
          "model": "zai-org-glm-5",
          "messages": [
            {"role": "user", "content": "What are the latest developments in AI?"}
          ],
          "venice_parameters": {
            "enable_web_search": "auto",
            "include_venice_system_prompt": true
          }
        }'
      ```
    </CodeGroup>

    Consulta tutti i [parametri disponibili](https://docs.venice.ai/api-reference/api-spec#venice-parameters).
  </Step>

  <Step title="Abilita lo streaming (opzionale)">
    Trasmetti le risposte in tempo reale usando `stream=True`:

    <CodeGroup>
      ```python Python theme={"system"}
      import os
      from openai import OpenAI

      client = OpenAI(
          api_key=os.environ.get("VENICE_API_KEY"),
          base_url="https://api.venice.ai/api/v1"
      )

      stream = client.chat.completions.create(
          model="zai-org-glm-5",
          messages=[{"role": "user", "content": "Write a short story about AI"}],
          stream=True
      )

      for chunk in stream:
          if chunk.choices and chunk.choices[0].delta.content is not None:
              print(chunk.choices[0].delta.content, end="")
      ```

      ```javascript Node.js theme={"system"}
      import OpenAI from 'openai';

      const client = new OpenAI({
          apiKey: process.env.VENICE_API_KEY,
          baseURL: 'https://api.venice.ai/api/v1'
      });

      const stream = await client.chat.completions.create({
          model: 'zai-org-glm-5',
          messages: [{ role: 'user', content: 'Write a short story about AI' }],
          stream: true
      });

      for await (const chunk of stream) {
          if (chunk.choices && chunk.choices[0]?.delta?.content) {
              process.stdout.write(chunk.choices[0].delta.content);
          }
      }
      ```

      ```bash cURL theme={"system"}
      curl https://api.venice.ai/api/v1/chat/completions \
        -H "Authorization: Bearer $VENICE_API_KEY" \
        -H "Content-Type: application/json" \
        -d '{
          "model": "zai-org-glm-5",
          "messages": [
            {"role": "user", "content": "Write a short story about AI"}
          ],
          "stream": true
        }'
      ```
    </CodeGroup>
  </Step>

  <Step title="Personalizza il comportamento delle risposte (opzionale)">
    Controlla come il modello risponde con parametri come temperature, max tokens e altri:

    <CodeGroup>
      ```python Python theme={"system"}
      import os
      from openai import OpenAI

      client = OpenAI(
          api_key=os.environ.get("VENICE_API_KEY"),
          base_url="https://api.venice.ai/api/v1"
      )

      completion = client.chat.completions.create(
          model="zai-org-glm-5",
          messages=[
              {"role": "system", "content": "You are a creative storyteller"},
              {"role": "user", "content": "Tell me a creative story"}
          ],
          temperature=0.8,
          max_tokens=500,
          top_p=0.9,
          frequency_penalty=0.5,
          presence_penalty=0.5,
          extra_body={
              "venice_parameters": {
                  "include_venice_system_prompt": False
              }
          }
      )

      print(completion.choices[0].message.content)
      ```

      ```javascript Node.js theme={"system"}
      import OpenAI from 'openai';

      const client = new OpenAI({
          apiKey: process.env.VENICE_API_KEY,
          baseURL: 'https://api.venice.ai/api/v1'
      });

      const completion = await client.chat.completions.create({
          model: 'zai-org-glm-5',
          messages: [
              { role: 'system', content: 'You are a creative storyteller' },
              { role: 'user', content: 'Tell me a creative story' }
          ],
          temperature: 0.8,
          max_tokens: 500,
          top_p: 0.9,
          frequency_penalty: 0.5,
          presence_penalty: 0.5,
          venice_parameters: {
              include_venice_system_prompt: false
          }
      });

      console.log(completion.choices[0].message.content);
      ```

      ```bash cURL theme={"system"}
      curl https://api.venice.ai/api/v1/chat/completions \
        -H "Authorization: Bearer $VENICE_API_KEY" \
        -H "Content-Type: application/json" \
        -d '{
          "model": "zai-org-glm-5",
          "messages": [
            {"role": "system", "content": "You are a creative storyteller"},
            {"role": "user", "content": "Tell me a creative story"}
          ],
          "temperature": 0.8,
          "max_tokens": 500,
          "top_p": 0.9,
          "frequency_penalty": 0.5,
          "presence_penalty": 0.5,
          "stream": false,
          "venice_parameters": {
            "include_venice_system_prompt": false
          }
        }'
      ```
    </CodeGroup>

    Consulta la [documentazione di Chat Completions](/api-reference/endpoint/chat/completions) per maggiori informazioni su tutti i parametri supportati.
  </Step>
</Steps>

***

## Prossimi passi

Ora che hai effettuato le tue prime richieste, esplora tutto ciò che la Venice API ha da offrire:

<CardGroup cols={2}>
  <Card title="Sfoglia i modelli" icon="database" href="/overview/models">
    Confronta tutti i modelli disponibili con le loro capacità, prezzi e limiti di contesto
  </Card>

  <Card title="Riferimento API" icon="code" href="/api-reference/api-spec">
    Esplora la documentazione API dettagliata con tutti gli endpoint e i parametri
  </Card>

  <Card title="Risposte strutturate" icon="brackets-curly" href="/guides/features/structured-responses">
    Scopri come ottenere risposte JSON con schemi garantiti
  </Card>

  <Card title="Guida agli agenti AI" icon="robot" href="/guides/integrations/ai-agents">
    Sviluppa con app di agenti, coding agent, strumenti MCP, skill e flussi di lavoro crypto
  </Card>
</CardGroup>

### Risorse aggiuntive

<CardGroup cols={2}>
  <Card title="Rate limiting" icon="gauge" href="/api-reference/rate-limiting">
    Comprendi i limiti di velocità e le best practice per l'uso in produzione
  </Card>

  <Card title="Codici di errore" icon="triangle-exclamation" href="/api-reference/error-codes">
    Riferimento per la gestione degli errori API e la risoluzione dei problemi
  </Card>

  <Card title="Collezione Postman" icon="bolt" href="/guides/getting-started/postman">
    Importa la nostra collezione Postman completa per testare facilmente
  </Card>

  <Card title="Privacy e sicurezza" icon="shield" href="/overview/privacy">
    Scopri l'architettura privacy-first di Venice e la gestione dei dati
  </Card>
</CardGroup>

***

## Serve aiuto?

* **Community Discord**: Unisciti al nostro [server Discord](https://discord.gg/askvenice) per supporto e discussioni
* **Documentazione**: Sfoglia il nostro [riferimento API completo](/api-reference/api-spec)
* **Pagina di stato**: Verifica lo stato del servizio su [veniceai-status.com](https://veniceai-status.com)
* **Twitter**: Segui [@AskVenice](https://x.com/AskVenice) per aggiornamenti

<Resources />