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

1. Ottieni la tua chiave API

   Vai alle Impostazioni Venice API e genera una nuova chiave API.

   Per una guida dettagliata, consulta la guida alle chiavi API.

2. Configura la tua chiave API

   Aggiungi la tua chiave API all’ambiente. Puoi esportarla nella tua shell:

   export VENICE_API_KEY='your-api-key-here'
   

   Oppure aggiungerla a un file .env nel tuo progetto:

   VENICE_API_KEY=your-api-key-here
   
3. 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.

   Python

   pip install openai
   

   npm install openai
   
4. Invia la tua prima richiesta

   Python

   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)
   

   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);
   

   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?"}
       ]
     }'
   

   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)
5. 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

   Visualizza tutti i modelli

   Sfoglia l’elenco completo dei modelli con prezzi, capacità e limiti di contesto

6. Utilizza i Venice Parameters

   Puoi abilitare funzionalità specifiche di Venice come la ricerca web tramite venice_parameters:

   Python

   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)
   

   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);
   

   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
       }
     }'
   

   Consulta tutti i parametri disponibili.

7. Abilita lo streaming (opzionale)

   Trasmetti le risposte in tempo reale usando stream=True:

   Python

   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="")
   

   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);
       }
   }
   

   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
     }'
   
8. Personalizza il comportamento delle risposte (opzionale)

   Controlla come il modello risponde con parametri come temperature, max tokens e altri:

   Python

   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)
   

   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);
   

   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
       }
     }'
   

   Consulta la documentazione di Chat Completions per maggiori informazioni su tutti i parametri supportati.

---

​

Prossimi passi

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

Sfoglia i modelli

Confronta tutti i modelli disponibili con le loro capacità, prezzi e limiti di contesto

Riferimento API

Esplora la documentazione API dettagliata con tutti gli endpoint e i parametri

Risposte strutturate

Scopri come ottenere risposte JSON con schemi garantiti

Guida agli agenti AI

Sviluppa con app di agenti, coding agent, strumenti MCP, skill e flussi di lavoro crypto

​

Risorse aggiuntive

Rate limiting

Comprendi i limiti di velocità e le best practice per l’uso in produzione

Codici di errore

Riferimento per la gestione degli errori API e la risoluzione dei problemi

Collezione Postman

Importa la nostra collezione Postman completa per testare facilmente

Privacy e sicurezza

Scopri l’architettura privacy-first di Venice e la gestione dei dati

---

​

Serve aiuto?

• Community Discord: Unisciti al nostro server Discord per supporto e discussioni
• Documentazione: Sfoglia il nostro riferimento API completo
• Pagina di stato: Verifica lo stato del servizio su veniceai-status.com
• Twitter: Segui @AskVenice per aggiornamenti