الانتقال إلى المحتوى الرئيسي
ابدأ باستخدام 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 الخام، يمكنك تخطي هذه الخطوة.
pip install openai
npm install openai
4

أرسل طلبك الأول

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:
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:
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 والمزيد:
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 التي تعطي الأولوية للخصوصية وطريقة التعامل مع البيانات

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