البدء السريع

بدء سريع لواجهة Venice API — أنشئ مفتاح API، وأرسل أول طلب إكمال محادثة، واستكشف نقاط نهاية الصور والفيديو والصوت في دقائق.

ابدأ باستخدام Venice API في دقائق. أنشئ مفتاح API، وأرسل أول طلب، وابدأ في البناء.

​

البدء السريع

1. احصل على مفتاح API الخاص بك

   توجّه إلى إعدادات Venice API الخاصة بك وأنشئ مفتاح API جديدًا.

   للاطلاع على شرح تفصيلي، راجع دليل مفتاح API.

2. إعداد مفتاح API الخاص بك

   أضف مفتاح API إلى بيئتك. يمكنك تصديره في الصدفة (shell):

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

   أو أضفه إلى ملف .env في مشروعك:

   VENICE_API_KEY=your-api-key-here
   
3. تثبيت SDK

   Venice متوافق مع OpenAI، لذا يمكنك استخدام OpenAI SDK. إذا كنت تفضّل استخدام cURL أو طلبات HTTP الخام، يمكنك تخطي هذه الخطوة.

   Python

   pip install openai
   

   npm install openai
   
4. أرسل طلبك الأول

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

   أدوار الرسائل:

   • system - تعليمات حول كيفية تصرّف النموذج
   • user - مطالباتك أو أسئلتك
   • assistant - استجابات النموذج السابقة (للمحادثات متعددة الأدوار)
   • tool - نتائج استدعاء الدوال (عند استخدام الأدوات)
5. بدّل النماذج عن طريق تغيير معرّف النموذج

   كل طلب يتضمّن معرّف model. لاستخدام نموذج مختلف، غيّر قيمة model في طلبك. الخيارات الشائعة:

   • zai-org-glm-5 - النموذج الافتراضي لمعظم حالات الاستخدام
   • kimi-k2-6 - استدلال قوي للمهام الأكثر تعقيدًا
   • claude-opus-4-8 - نموذج عالي الذكاء للمهام المعقدة
   • venice-uncensored-1-2 - نموذج Venice غير الخاضع للرقابة

   عرض جميع النماذج

   تصفّح القائمة الكاملة للنماذج مع الأسعار والقدرات وحدود السياق

6. استخدام معاملات Venice

   يمكنك تفعيل ميزات خاصة بـ Venice مثل البحث على الويب باستخدام 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
       }
     }'
   

   اطّلع على جميع المعاملات المتاحة.

7. تفعيل البث المباشر (اختياري)

   قم ببث الاستجابات في الوقت الحقيقي باستخدام 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. تخصيص سلوك الاستجابة (اختياري)

   تحكّم في كيفية استجابة النموذج باستخدام معاملات مثل temperature و max tokens والمزيد:

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

   اطّلع على وثائق Chat Completions لمزيد من المعلومات حول جميع المعاملات المدعومة.

---

​

الخطوات التالية

الآن بعد أن أرسلت طلباتك الأولى، استكشف المزيد مما يقدّمه Venice API:

تصفّح النماذج

قارن جميع النماذج المتاحة مع قدراتها وأسعارها وحدود السياق

مرجع API

استكشف وثائق API التفصيلية مع جميع نقاط النهاية والمعاملات

الاستجابات المنظّمة

تعرّف على كيفية الحصول على استجابات JSON بمخطّطات مضمونة

دليل وكلاء الذكاء الاصطناعي

ابنِ باستخدام تطبيقات الوكلاء ووكلاء البرمجة وأدوات MCP والمهارات وسير عمل العملات المشفّرة

​

موارد إضافية

تحديد المعدّل

افهم حدود المعدّل وأفضل الممارسات للاستخدام في الإنتاج

رموز الأخطاء

مرجع للتعامل مع أخطاء API واستكشاف المشكلات وإصلاحها

مجموعة Postman

استورد مجموعة Postman الكاملة الخاصة بنا لسهولة الاختبار

الخصوصية والأمان

تعرّف على بنية Venice التي تعطي الأولوية للخصوصية وطريقة التعامل مع البيانات

---

​

تحتاج إلى مساعدة؟

• مجتمع Discord: انضم إلى خادم Discord الخاص بنا للحصول على الدعم والمناقشات
• الوثائق: تصفّح مرجع API الكامل الخاص بنا
• صفحة الحالة: تحقّق من حالة الخدمة على veniceai-status.com
• Twitter: تابع @AskVenice لمعرفة التحديثات