Venice CLI

La Venice CLI è l’interfaccia a riga di comando ufficiale di Venice. Chatta con i modelli AI, genera immagini, converti testo in voce, trascrivi audio, genera video e molto altro—tutto dal tuo terminale, con crittografia end-to-end opzionale.

GitHub: veniceai/venice-cli

Pubblicata come veniceai-cli su npm. Licenza MIT.

Privacy-first

E2EE opzionale e attestazione TEE. Nessuna telemetria, nessun tracciamento del browser.

Ogni modalità

Chat, ricerca, immagini, upscale, TTS, trascrizione, video ed embeddings

Scriptabile

Output JSON e raw, piping da stdin e completion di shell per bash, zsh, fish

Avvio rapido

Installa la CLI

Installala globalmente con npm:

npm install -g veniceai-cli

Oppure eseguila senza installarla:

npx veniceai-cli chat 'Hello, world!'

Ottieni una API key Venice

Generane una da venice.ai/settings/api. Consulta la guida sulle API key per istruzioni passo passo.

Configura la tua key

Esegui la configurazione interattiva e incolla la tua key quando richiesto, così non apparirà mai nella cronologia della shell o nell’elenco dei processi:

venice config init

Oppure usa invece una variabile d’ambiente:

export VENICE_API_KEY=YOUR_API_KEY

$env:VENICE_API_KEY = "YOUR_API_KEY"

Inizia a chattare

venice chat "What is the meaning of life?"

Richiede Node.js 18.0.0 o superiore. VENICE_API_KEY ha la precedenza su qualsiasi valore salvato nel file di configurazione.

Risoluzione dei problemi: comando `venice` non trovato

Se il terminale segnala che venice non è riconosciuto dopo npm install -g veniceai-cli, la cartella globale dei binari di npm non è nel tuo PATH. Succede spesso su Windows.

Esegui npm config get prefix per trovare la cartella di installazione globale di npm.
Aggiungi la cartella globale dei binari al tuo PATH. Su Windows è la cartella del prefisso stessa (di solito %AppData%\npm). Su macOS e Linux è la sottocartella bin del prefisso.
Apri una nuova finestra del terminale ed esegui venice chat "Hello".

Per evitare la configurazione del PATH, esegui la CLI tramite npx, ad esempio npx veniceai-cli chat "Hello".

Comandi

Comando	Cosa fa
`venice chat <prompt>`	Chatta con qualsiasi modello testuale di Venice, con tool, character e streaming
`venice search <query>`	Ricerca web con sintesi AI e citazioni opzionali
`venice image <prompt>`	Genera un’immagine da un prompt testuale
`venice upscale <file>`	Esegue l’upscale di un’immagine esistente fino a 4×
`venice tts <text>`	Text-to-speech con oltre 35 voci
`venice transcribe <file>`	Speech-to-text con timestamp opzionali
`venice video <subcommand>`	Metti in coda, esegui polling e scarica video generati dall’AI
`venice embeddings <text>`	Genera vettori di embedding
`venice models`	Elenca e filtra il catalogo modelli live
`venice tee <subcommand>`	Recupera e verifica l’attestazione TEE
`venice config <subcommand>`	Gestisci API key e valori predefiniti
`venice history <subcommand>`	Elenca, mostra, esporta o cancella conversazioni
`venice usage`	Mostra l’utilizzo dei token nel tempo
`venice characters` / `venice voices`	Elenca i personaggi integrati e le voci TTS
`venice completions <shell>`	Genera i completamenti della shell

Chat

# Basic chat
venice chat "Explain quantum computing in simple terms"

# Use a specific model and system prompt
venice chat -m deepseek-v3.2 -s "You are a helpful coding assistant" "Write fizzbuzz in Python"

# Continue the previous conversation
venice chat --continue "What about the next step?"

# Function calling with built-in tools
venice chat -t calculator,datetime "What's 25 * 4.5, and what day is it?"

# JSON output for scripting
venice chat -f json "List 3 colors" | jq '.content'

Opzioni chat comuni:

Opzione	Descrizione
`-m, --model <model>`	Modello da usare (default: `kimi-k2-5`)
`-s, --system <prompt>`	System prompt
`-c, --character <name>`	Persona del character
`-t, --tools <tools>`	Elenco separato da virgole di tool integrati
`--continue`	Continua l’ultima conversazione
`--web-search`	Abilita la ricerca web per informazioni aggiornate
`--no-stream`	Disabilita l’output in streaming
`-f, --format <format>`	Formato di output (`pretty`, `json`, `markdown`, `raw`)
`--e2ee` / `--no-e2ee`	Forza o disabilita la crittografia end-to-end
`--tee-verify`	Mostra i dettagli dell’attestazione TEE
`-q, --quiet`	Nascondi i messaggi di stato E2EE/TEE

Ricerca web

venice search "Latest developments in fusion energy"
venice search -n 10 --citations "Best practices for TypeScript"
venice search --scrape "Company research on Anthropic"

Generazione di immagini e upscaling

# Generate and save an image
venice image -o sunset.png "A serene mountain lake at sunset"

# Custom dimensions and model
venice image -w 1024 -h 768 -m flux-1-dev "Landscape photograph"

# Upscale an existing image 4×
venice upscale photo.jpg -s 4 -o photo_4x.jpg

Text-to-speech e trascrizione

# Speak with a specific voice
venice tts -v bf_emma -o greeting.mp3 "Good morning, everyone!"

# Pipe text in from stdin
echo "Text to speak" | venice tts -o output.mp3

# Transcribe audio with timestamps
venice transcribe -t recording.mp3

# Choose a model and language hint
venice transcribe -m openai/whisper-large-v3 -l es spanish_audio.mp3

Generazione video

La generazione video è asincrona (basata su coda).

# Queue a text-to-video generation
venice video generate -m veo3-fast-text-to-video "Cinematic sunset over mountains"

# Image-to-video with a reference image
venice video generate -m wan-2.6-image-to-video -i photo.jpg "The scene comes alive"

# Poll until done, then download
venice video status -w <queue_id>
venice video retrieve <queue_id> -o my_video.mp4

# List available video models
venice video models

Modelli ed embeddings

# List and filter the catalog
venice models -t image
venice models --privacy
venice models --e2ee

# Generate embeddings
venice embeddings -o vectors.json "Text to embed"

Configurazione

# Interactive setup
venice config init

# Set and inspect values
venice config set default_model kimi-k2-5
venice config get default_model
venice config show
venice config path

Chiave	Descrizione
`api_key`	La tua API key Venice
`default_model`	Modello di chat predefinito
`default_image_model`	Modello di generazione immagini predefinito
`default_voice`	Voce TTS predefinita
`output_format`	Formato di output predefinito
`show_usage`	Mostra l’utilizzo dei token dopo le richieste

Privacy: E2EE e TEE

Venice CLI è costruita per la privacy. Non invia telemetria, memorizza la tua API key localmente con permessi ristretti e supporta i modelli di calcolo confidenziale di Venice.

Crittografia end-to-end (E2EE): I messaggi vengono crittografati lato client e decrittografati solo all’interno del TEE, quindi Venice non può leggere i tuoi dati. La CLI abilita automaticamente E2EE quando un modello dichiara la capacità, generando una coppia di chiavi effimere per sessione (ECDH + AES-GCM).
Attestazione TEE: Verifica crittograficamente che un modello venga eseguito in un enclave sicuro prima di inviare dati.

# Discover confidential-compute models
venice models --e2ee
venice models --tee

# Chat with E2EE (auto-enabled for capable models)
venice chat -m <e2ee-capable-model> "Your private message here"

# TEE-only mode: verify attestation without encryption
venice chat -m <e2ee-capable-model> --no-e2ee "TEE verified, not encrypted"

# Fetch and verify attestation directly
venice tee attestation <model>
venice tee verify <model>

La modalità E2EE disabilita tool e ricerca web per preservare la crittografia end-to-end.

Formati di output

Formato	Caso d’uso
`pretty`	Output colorato e formattato per l’uso interattivo (default)
`json`	JSON leggibile dalla macchina per scripting e piping
`markdown`	Output formattato in Markdown per la documentazione
`raw`	Testo semplice senza decorazioni, per i pipe

La CLI rileva automaticamente quando l’output viene reindirizzato a un pipe e passa a raw.

venice chat -f json "List items" | jq '.'
venice chat "Generate code" | pbcopy

Risorse

GitHub

Codice sorgente, issue e release

npm

veniceai-cli

Server MCP di Venice

Esponi gli stessi tool Venice a qualsiasi host MCP

Riferimento API Venice

Documentazione completa di endpoint e parametri

Documentazione

Per iniziare

Testo e chat

Immagini

Video

Audio

Ricerca e RAG

Agenti e integrazioni

Strumenti di sviluppo

Strumenti per agenti

SDK e framework

GitHub: veniceai/venice-cli

Privacy-first

Ogni modalità

Scriptabile

Avvio rapido

Risoluzione dei problemi: comando `venice` non trovato

Comandi

Chat

Ricerca web

Generazione di immagini e upscaling

Text-to-speech e trascrizione

Generazione video

Modelli ed embeddings

Configurazione

Privacy: E2EE e TEE

Formati di output

Risorse

GitHub

npm

Server MCP di Venice

Riferimento API Venice

GitHub: veniceai/venice-cli

Privacy-first

Ogni modalità

Scriptabile

​Avvio rapido

​Risoluzione dei problemi: comando venice non trovato

​Comandi

​Chat

​Ricerca web

​Generazione di immagini e upscaling

​Text-to-speech e trascrizione

​Generazione video

​Modelli ed embeddings

​Configurazione

​Privacy: E2EE e TEE

​Formati di output

​Risorse

GitHub

npm

Server MCP di Venice

Riferimento API Venice

Avvio rapido

Risoluzione dei problemi: comando `venice` non trovato

Comandi

Chat

Ricerca web

Generazione di immagini e upscaling

Text-to-speech e trascrizione

Generazione video

Modelli ed embeddings

Configurazione

Privacy: E2EE e TEE

Formati di output

Risorse