> ## 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.
# Venice CLI
> واجهة سطر أوامر Venice الرسمية تُتيح لك الدردشة والبحث على الويب وتوليد الصور وتحويل النص إلى كلام والنسخ الصوتي والفيديو و embeddings من الطرفية مع تشفير اختياري من طرف إلى طرف.
[Venice CLI](https://github.com/veniceai/venice-cli) هي واجهة سطر الأوامر الرسمية لـ Venice. دردش مع نماذج الذكاء الاصطناعي، وأنشئ الصور، وحوّل النص إلى كلام، وانسخ الصوت نصيًا، وأنشئ الفيديو، والمزيد—كل ذلك من طرفيتك، مع تشفير اختياري من طرف إلى طرف.
منشورة كـ [`veniceai-cli`](https://www.npmjs.com/package/veniceai-cli) على npm. مرخصة تحت MIT.
E2EE اختياري وتحقق TEE. لا تتبع، ولا تعقّب متصفح.
الدردشة، والبحث، والصور، والترقية، و TTS، والنسخ النصي، والفيديو، و embeddings
مخرجات JSON وخام، وتوجيه stdin، وإكمالات shell لـ bash و zsh و fish
## البدء السريع
ثبّتها بشكل عام باستخدام npm:
```bash theme={"system"}
npm install -g veniceai-cli
```
أو شغّلها دون تثبيت:
```bash theme={"system"}
npx veniceai-cli chat 'Hello, world!'
```
أنشئ واحدًا من [venice.ai/settings/api](https://venice.ai/settings/api). انظر [دليل مفتاح API](/guides/getting-started/generating-api-key) للحصول على تعليمات خطوة بخطوة.
شغّل الإعداد التفاعلي والصق مفتاحك عند الطلب، حتى لا يظهر أبدًا في سجل shell أو قائمة العمليات:
```bash theme={"system"}
venice config init
```
أو استخدم متغير بيئة بدلًا من ذلك:
```bash theme={"system"}
export VENICE_API_KEY=YOUR_API_KEY
```
```bash theme={"system"}
venice chat "What is the meaning of life?"
```
يتطلب Node.js 18.0.0 أو أعلى. يتجاوز `VENICE_API_KEY` أي قيمة مخزنة في ملف التكوين.
## الأوامر
| الأمر | ما الذي يفعله |
| ------------------------------------- | ------------------------------------------------------------------------- |
| `venice chat ` | دردش مع أي نموذج نصي من Venice، مع الأدوات والشخصيات والبث المباشر |
| `venice search ` | بحث على الويب مع تجميع بالذكاء الاصطناعي واستشهادات اختيارية |
| `venice image ` | توليد صورة من مطالبة نصية |
| `venice upscale ` | ترقية صورة موجودة حتى 4× |
| `venice tts ` | تحويل النص إلى كلام بأكثر من 35 صوتًا |
| `venice transcribe ` | تحويل الكلام إلى نص مع طوابع زمنية اختيارية |
| `venice video ` | وضع في قائمة الانتظار، واستطلاع، وتنزيل الفيديو المُنشأ بالذكاء الاصطناعي |
| `venice embeddings ` | توليد متجهات embedding |
| `venice models` | عرض وتصفية كتالوج النماذج الحي |
| `venice tee ` | جلب والتحقق من تصديق TEE |
| `venice config ` | إدارة مفتاح API والقيم الافتراضية |
| `venice history ` | عرض أو إظهار أو تصدير أو مسح المحادثات |
| `venice usage` | إظهار استخدام الرموز عبر الزمن |
| `venice characters` / `venice voices` | عرض الشخصيات المدمجة وأصوات TTS |
| `venice completions ` | توليد إكمالات shell |
### الدردشة
```bash theme={"system"}
# 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'
```
خيارات الدردشة الشائعة:
| الخيار | الوصف |
| ------------------------ | ---------------------------------------------------- |
| `-m, --model ` | النموذج المُستخدم (الافتراضي: `kimi-k2-5`) |
| `-s, --system ` | مطالبة النظام |
| `-c, --character ` | شخصية persona |
| `-t, --tools ` | قائمة مفصولة بفواصل من الأدوات المدمجة |
| `--continue` | استكمل المحادثة الأخيرة |
| `--web-search` | تفعيل البحث على الويب للمعلومات الحالية |
| `--no-stream` | تعطيل مخرجات البث المباشر |
| `-f, --format ` | تنسيق المخرجات (`pretty`, `json`, `markdown`, `raw`) |
| `--e2ee` / `--no-e2ee` | فرض أو تعطيل التشفير من طرف إلى طرف |
| `--tee-verify` | إظهار تفاصيل تصديق TEE |
| `-q, --quiet` | إخفاء رسائل حالة E2EE/TEE |
### البحث على الويب
```bash theme={"system"}
venice search "Latest developments in fusion energy"
venice search -n 10 --citations "Best practices for TypeScript"
venice search --scrape "Company research on Anthropic"
```
### توليد الصور والترقية
```bash theme={"system"}
# 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
```
### تحويل النص إلى كلام والنسخ النصي
```bash theme={"system"}
# 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
```
### توليد الفيديو
توليد الفيديو غير متزامن (قائم على قائمة انتظار).
```bash theme={"system"}
# 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
venice video retrieve -o my_video.mp4
# List available video models
venice video models
```
### النماذج و embeddings
```bash theme={"system"}
# 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"
```
### التكوين
```bash theme={"system"}
# 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
```
| المفتاح | الوصف |
| --------------------- | -------------------------------- |
| `api_key` | مفتاح Venice API الخاص بك |
| `default_model` | نموذج الدردشة الافتراضي |
| `default_image_model` | نموذج توليد الصور الافتراضي |
| `default_voice` | صوت TTS الافتراضي |
| `output_format` | تنسيق المخرجات الافتراضي |
| `show_usage` | إظهار استخدام الرموز بعد الطلبات |
## الخصوصية: E2EE و TEE
بُنيت Venice CLI للخصوصية. لا ترسل أي تتبع، وتخزّن مفتاح API الخاص بك محليًا بأذونات مقيدة، وتدعم نماذج الحوسبة السرية من Venice.
* **التشفير من طرف إلى طرف (E2EE)**: تُشفَّر الرسائل على جانب العميل ولا تُفكّ إلا داخل TEE، لذا لا يمكن لـ Venice قراءة بياناتك. يُفعّل CLI E2EE تلقائيًا عندما يُعلن نموذج عن هذه القدرة، مُولّدًا زوج مفاتيح مؤقت لكل جلسة (ECDH + AES-GCM).
* **تصديق TEE**: تحقق تشفيريًا من أن النموذج يعمل في enclave آمن قبل إرسال البيانات.
```bash theme={"system"}
# Discover confidential-compute models
venice models --e2ee
venice models --tee
# Chat with E2EE (auto-enabled for capable models)
venice chat -m "Your private message here"
# TEE-only mode: verify attestation without encryption
venice chat -m --no-e2ee "TEE verified, not encrypted"
# Fetch and verify attestation directly
venice tee attestation
venice tee verify
```
يُعطّل وضع E2EE الأدوات والبحث على الويب للحفاظ على التشفير من طرف إلى طرف.
## تنسيقات المخرجات
| التنسيق | حالة الاستخدام |
| ---------- | --------------------------------------------------- |
| `pretty` | مخرجات ملونة ومنسّقة للاستخدام التفاعلي (الافتراضي) |
| `json` | JSON قابل للقراءة آليًا للبرمجة النصية والتوجيه |
| `markdown` | مخرجات منسّقة بـ markdown للتوثيق |
| `raw` | نص عادي بدون تزيين، للأنابيب |
يكتشف CLI تلقائيًا عندما تكون المخرجات مُوجَّهة إلى أنبوب ويتحوّل إلى `raw`.
```bash theme={"system"}
venice chat -f json "List items" | jq '.'
venice chat "Generate code" | pbcopy
```
## الموارد
شفرة المصدر والمشكلات والإصدارات
`veniceai-cli`
اكشف نفس أدوات Venice لأي مضيف MCP
توثيق كامل لنقاط النهاية والمعاملات