كيفية استخدام Venice API (دليل شامل)

ماذا لو تمكنت من تبديل مزودي الذكاء الاصطناعي دون إعادة كتابة سطر واحد من التعليمات البرمجية؟ تقدم Venice API ذلك بالضبط: نقاط نهاية متوافقة مع OpenAI مع عدم الاحتفاظ بالبيانات، وخيارات نماذج غير خاضعة للرقابة، وبنية معمارية تعطي الأولوية للخصوصية وتتحكم فيها أنت.

تجبرك معظم واجهات برمجة تطبيقات الذكاء الاصطناعي على استخدام حزم SDK خاصة بمورد معين، وتحتفظ ببياناتك لتدريب النماذج، وتفرض أسعارًا مميزة على الميزات الأساسية. يتعين عليك إعادة كتابة تطبيقك عند تبديل المزودين. تقوم مطالباتك بتدريب نماذج المنافسين. تتصاعد تكاليفك بشكل غير متوقع.

تلغي Venice API هذه النقاط الشائكة. إنها تعكس بنية واجهة برمجة تطبيقات OpenAI تمامًا؛ ما عليك سوى تغيير عنوان URL الأساسي ويعمل التعليمات البرمجية الموجودة لديك على الفور. تظل بياناتك خاصة. يمكنك الاختيار من بين نماذج دفع متعددة بما في ذلك التخزين المؤقت للعملات المشفرة ورصيد الدولار للدفع حسب الاستخدام.

💡

هل تريد أداة رائعة لاختبار واجهات برمجة التطبيقات (API) تُنشئ وثائق API جميلة؟

هل تريد منصة متكاملة وشاملة لفريق المطورين الخاص بك للعمل معًا بأقصى إنتاجية؟

يلبي Apidog جميع متطلباتك، ويحل محل Postman بسعر أقل بكثير!

button

إنشاء مفتاح API الخاص بك في Venice

1. انتقل إلى venice.ai/settings/api.

2. انقر على "إنشاء مفتاح API جديد" وقم بتكوين بيانات الاعتماد الخاصة بك:

الوصف: قم بتسمية مفتاحك للتنظيم
النوع: مفاتيح المسؤول تدير المفاتيح الأخرى برمجيًا؛ مفاتيح الاستدلال فقط تشغل النماذج حصريًا
تاريخ الانتهاء: تاريخ اختياري يتم فيه إلغاء تنشيط المفتاح تلقائيًا
حدود الاستهلاك: حدود يومية لـ Diem أو الدولار الأمريكي للتحكم في الإنفاق

3. انسخ مفتاحك فورًا. تعرضه Venice مرة واحدة فقط! قم بتخزينه في متغيرات البيئة، ولا تضعه أبدًا في مستودعات التعليمات البرمجية.

export VENICE_API_KEY="your-key-here"

اعتبارات أمن المفتاح

توفر مفاتيح المسؤول وصولاً واسعًا إلى حسابك في Venice. تعامل معها كبيانات اعتماد جذرية – استخدمها لبرامج تدوير المفاتيح وإدارة الفريق، ولا تستخدمها أبدًا في تعليمات برمجية للتطبيق. تقيد مفاتيح الاستدلال فقط العمليات بتنفيذ النموذج، مما يحد من التعرض في حالة تسريبها. قم بتدوير المفاتيح فصليًا باستخدام سجلات النشاط في لوحة التحكم لتحديد بيانات الاعتماد القديمة.

المصادقة والتكوين الأساسي لواجهة برمجة تطبيقات Venice

تستخدم Venice مصادقة رمز Bearer القياسية. يتطلب كل طلب رأسين:

Authorization: Bearer $VENICE_API_KEY
Content-Type: application/json

يتبع عنوان URL الأساسي نمط OpenAI تمامًا:

import openai
import os

client = openai.OpenAI(
    api_key=os.getenv("VENICE_API_KEY"),
    base_url="https://api.venice.ai/api/v1"
)

يقوم هذا التغيير الوحيد في التكوين بتوجيه جميع استدعاءات حزمة SDK الحالية الخاصة بك لـ OpenAI عبر بنية Venice التحتية. لا توجد تغييرات في الطرق. لا توجد إعادة كتابة للمعلمات. تعمل التعليمات البرمجية الخاصة بك على الفور.

توافق حزمة SDK

تحافظ Venice على التوافق مع حزم SDK الرسمية لـ OpenAI عبر Python وTypeScript وGo وPHP وC# وJava وSwift. تعمل أيضًا المكتبات الخارجية المبنية على مواصفات OpenAI دون تعديل. اختبر قاعدة التعليمات البرمجية الحالية لديك مقابل Venice عن طريق تغيير عنوان URL الأساسي ومفتاح API فقط – إذا كنت تستخدم إكمال الدردشة القياسي أو التدفق أو استدعاء الوظائف، فإن عملية الترحيل تستغرق دقائق.

الترحيل من OpenAI

يتطلب الترحيل ثلاثة تغييرات: عنوان URL الأساسي، ومفتاح API، واسم النموذج. استبدل https://api.openai.com/v1 بـ https://api.venice.ai/api/v1. استبدل مفتاح OpenAI API الخاص بك بمفتاح Venice الخاص بك. غيّر معرفات النموذج من gpt-4 أو gpt-3.5-turbo إلى مكافئات Venice مثل qwen3-4b. اختبر جيدًا قبل النشر في الإنتاج. تحقق من معالجة استجابات التدفق بشكل صحيح. تأكد من صحة مخططات استدعاء الوظائف. تحقق من مطابقة معلمات إنشاء الصور لمتطلباتك. تتعامل طبقة التوافق في Venice مع معظم الحالات الهامشية، ولكن توجد اختلافات طفيفة في تنسيق رسائل الخطأ ورؤوس حد المعدل.

نصيحة احترافية: اختبر جميع نقاط نهاية API الخاصة بك بدقة باستخدام Apidog.

نقاط نهاية وإمكانيات Venice API الأساسية

توفر Venice تسع نقاط نهاية مميزة تغطي إنشاء النصوص والصور والصوت والفيديو:

توليد النصوص

/api/v1/chat/completions - ذكاء اصطناعي حواري مع دعم التدفق
/api/v1/embeddings/generate - تضمينات متجهة لتطبيقات RAG

معالجة الصور

/api/v1/image/generate - توليد النص إلى صورة
/api/v1/image/upscale - تحسين الدقة
/api/v1/image/edit - التلوين والتعديل المدعوم بالذكاء الاصطناعي

الصوت

/api/v1/audio/speech - تحويل النص إلى كلام
/api/v1/audio/transcriptions - تحويل الكلام إلى نص

الفيديو والشخصيات

/api/v1/video/queue - توليد النص/الفيديو إلى فيديو
/api/v1/characters/list - إدارة شخصيات الذكاء الاصطناعي

يحافظ كل نقطة نهاية على تنسيقات طلب/استجابة متوافقة مع OpenAI حيثما ينطبق ذلك. يمكنك إعادة استخدام منطق التحليل الحالي.

استراتيجية اختيار نقاط النهاية

قم بمطابقة نقاط النهاية مع تعقيد حالة الاستخدام الخاصة بك. تتعامل عمليات إكمال الدردشة مع معظم احتياجات إنشاء النصوص. أضف التضمينات للبحث الدلالي أو خطوط أنابيب RAG. استخدم نقاط نهاية الصور لسير العمل الإبداعي أو الإشراف على المحتوى. تمكن نقاط نهاية الصوت ميزات الوصول أو واجهات الصوت. ابدأ بنقطة نهاية واحدة، وتحقق من تكاملك، ثم وسّع نطاق عملك إلى سير عمل متعدد الوسائط.

العمل مع الاستجابات المتدفقة

يقلل التدفق من زمن الاستجابة الملحوظ لتطبيقات الدردشة. تستخدم Venice أحداث الخادم المرسلة (SSE) المطابقة لتطبيق OpenAI. قم بمعالجة المحتوى الجزئي فور وصوله بدلاً من انتظار الاستجابات الكاملة. تعامل مع إنهاء التدفق عن طريق التحقق من رسائل [DONE]. نفذ منطق إعادة الاتصال للتدفقات المتقطعة – قم بتخزين سجل المحادثات من جانب العميل وأعد محاولة الطلبات الفاشلة. راقب استخدام الرمز المميز في أجزاء التدفق لتتبع التكاليف في الوقت الفعلي.

معلمات خاصة بواجهة برمجة تطبيقات Venice

بالإضافة إلى معلمات OpenAI القياسية، تضيف Venice ضوابط للقدرات من خلال كائن venice_parameters:

{
  "model": "qwen3-4b",
  "messages": [{"role": "user", "content": "Latest AI developments?"}],
  "venice_parameters": {
    "enable_web_search": "on",
    "enable_web_citations": true,
    "strip_thinking_response": false
  }
}

تكامل البحث عبر الويب

اضبط enable_web_search على auto أو on أو off. يسمح "auto" للنموذج بتحديد متى تحسن المعلومات الحالية الاستجابات. قم بفرضه على "on" للاستعلامات في الوقت الفعلي حول الأحداث الأخيرة أو التقنيات سريعة التغير. قم بإقرانه بـ enable_web_citations لإرجاع عناوين URL للمصادر – وهو أمر ضروري لأدوات البحث والتحقق من الحقائق.

التحكم في الاستدلال

تعرض نماذج الاستدلال مثل DeepSeek R1 التفكير خطوة بخطوة افتراضيًا. اضبط strip_thinking_response على true لإرجاع الإجابات النهائية فقط، مما يقلل من استهلاك الرموز المميزة. استخدم disable_thinking لتجاوز الاستدلال تمامًا للاستعلامات البسيطة.

صيغة بديلة

مرر المعلمات عبر لاحقة النموذج لطلبات موجزة:

model="qwen3-4b:enable_web_search=on&enable_web_citations=true"

تسلسل المعلمات

تتجاوز المعلمات الخاصة بـ Venice الإعدادات الافتراضية ولكنها تحترم الإعدادات الصريحة. إذا قمت بتحديد temperature: 0.5 في الكائن الجذر و enable_web_search: on في venice_parameters، فسيتم تطبيق كلاهما في وقت واحد. اختبر مجموعات المعلمات بشكل منفصل قبل النشر في الإنتاج – تتفاعل بعض المعلمات بشكل غير متوقع مع نماذج معينة.

أمثلة تطبيق عملية عند استخدام Venice API

إكمال الدردشة الأساسي

curl --request POST \
  --url https://api.venice.ai/api/v1/chat/completions \
  --header "Authorization: Bearer $VENICE_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
    "model": "qwen3-4b",
    "messages": [{"role": "user", "content": "Explain zero-knowledge proofs"}],
    "stream": true
  }'

يعمل التدفق بشكل مماثل لـ OpenAI – قم بمعالجة أجزاء SSE فور وصولها.

استدعاء الوظائف

curl --request POST \
  --url https://api.venice.ai/api/v1/chat/completions \
  --header "Authorization: Bearer $VENICE_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
    "model": "qwen3-4b",
    "messages": [{"role": "user", "content": "Weather in Tokyo?"}],
    "tools": [{
      "type": "function",
      "function": {
        "name": "get_weather",
        "description": "Get weather for location",
        "parameters": {
          "type": "object",
          "properties": {
            "location": {"type": "string"}
          },
          "required": ["location"]
        }
      }
    }]
  }'

تدعم نماذج Venice استدعاء الوظائف المتوازي وتطبيق المخطط مثل تطبيق OpenAI.

توليد الصور

curl --request POST \
  --url https://api.venice.ai/api/v1/image/generate \
  --header "Authorization: Bearer $VENICE_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
    "model": "venice-sd35",
    "prompt": "Cyberpunk cityscape at night, neon reflections",
    "aspect_ratio": "16:9",
    "resolution": "2K",
    "hide_watermark": true
  }'

تشمل نسب العرض إلى الارتفاع المتاحة 1:1 و 4:3 و 16:9 و 21:9. خيارات الدقة هي 1K و 2K.

تحسين دقة الصور (Upscaling)

curl --request POST \
  --url https://api.venice.ai/api/v1/image/upscale \
  --header "Authorization: Bearer $VENICE_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
    "model": "upscale-sd35",
    "image": "base64encodedimage..."
  }'

تحليل الرؤية

curl --request POST \
  --url https://api.venice.ai/api/v1/chat/completions \
  --header "Authorization: Bearer $VENICE_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
    "model": "qwen3-vl-235b-a22b",
    "messages": [{
      "role": "user",
      "content": [
        {"type": "text", "text": "What architecture style is this?"},
        {"type": "image_url", "image_url": {"url": "data:image/jpeg;base64,..."}}
      ]
    }]
  }'

يمكن تمرير الصور كـ URIs بيانات base64 أو عناوين URL لـ HTTPS. تقبل نماذج الرؤية صورًا متعددة لكل رسالة لمهام المقارنة.

توليف الصوت

curl --request POST \
  --url https://api.venice.ai/api/v1/audio/speech \
  --header "Authorization: Bearer $VENICE_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
    "model": "tts-kokoro",
    "input": "Welcome to Venice API",
    "voice": "af_sky",
    "response_format": "mp3"
  }'

تستخدم خيارات الصوت بادئات: af_ (أنثى أمريكية)، am_ (ذكر أمريكي)، وأنماط مشابهة للهجات الأخرى.

أنماط معالجة الأخطاء

تُرجع Venice رموز حالة HTTP القياسية. يشير 401 إلى فشل المصادقة – تحقق من مفتاح API والرؤوس الخاصة بك. يشير 429 إلى تحديد المعدل؛ قم بتطبيق التراجع الأسي بدءًا من ثانية واحدة. تشير أخطاء 500 إلى مشكلات مؤقتة في البنية التحتية؛ أعد المحاولة بعد 5 ثوانٍ. قم بتحليل استجابات الأخطاء بحثًا عن رسائل محددة – تتضمن Venice أسباب الفشل التفصيلية في نص الاستجابة.

خصوصية وبنية البيانات في Venice API

تعمل سياسة Venice لعدم الاحتفاظ بالبيانات عبر بنية تقنية، وليس فقط وعودًا قانونية. يخزن متصفحك سجل المحادثات محليًا باستخدام IndexedDB. تعالج خوادم Venice المطالبات على وحدات معالجة الرسوميات (GPUs) التي لا ترى سوى الطلب الحالي – لا يوجد سجل محادثات، ولا بيانات تعريف لهوية المستخدم، ولا معلومات مفتاح API.

بعد إنشاء استجابة، تتخلص الخوادم من المطالبة والإخراج على الفور. لا يتم حفظ أي شيء على القرص أو في السجلات. لا تُستخدم بياناتك أبدًا لتدريب النماذج. يختلف هذا اختلافًا جوهريًا عن الخدمات المركزية التي تحتفظ بالبيانات لاكتشاف الانتهاكات وتحسين النماذج.

لتحقيق خصوصية إضافية، تستضيف Venice معظم النماذج على بنية تحتية خاصة بدلاً من الاعتماد على مزودي الطرف الثالث. تعمل الخيارات غير الخاضعة للرقابة على أجهزة تتحكم بها Venice، مما يضمن عدم وجود تصفية أو تسجيل خارجي.

التحقق من تدفق البيانات

راجع مطالبات Venice بالخصوصية عن طريق مراقبة حركة مرور الشبكة. تذهب طلبات API مباشرة إلى api.venice.ai بتشفير TLS. لا يتم تحميل أي برامج نصية لتحليلات الطرف الثالث في الوثائق. لا تظهر رؤوس الاستجابة أي توجيهات للتخزين المؤقت – مما يؤكد عدم الاحتفاظ بالبيانات من جانب الخادم. للتطبيقات الحساسة، قم بتطبيق التشفير من جانب العميل قبل إرسال المطالبات، على الرغم من أن هذا يمنع النموذج من فهم المحتوى.

خيارات التسعير والدفع في Venice API

تقدم Venice ثلاث طرق دفع لتناسب أنماط استخدامك. يكلف الاشتراك الاحترافي 18 دولارًا شهريًا ويتضمن 10 دولارات من أرصدة API بالإضافة إلى مطالبات غير محدودة على ميزات المستهلك. يتطلب تخزين DIEM شراء رموز VVV التي توفر مخصصات حوسبة يومية دائمة – مثالي للتطبيقات عالية الحجم ذات حركة المرور المتوقعة. يتيح لك الدفع بالدولار حسب الاستخدام تمويل حسابك بالدولار واستهلاك الأرصدة حسب الحاجة، وهو مثالي للتجريب وأعباء العمل المتغيرة.

لا يزال الوصول إلى API مجانيًا حاليًا خلال مرحلة البيتا. يتيح لك هذا التحقق من أنماط التكامل وتقدير التكاليف قبل الالتزام بطريقة دفع. راقب لوحة معلومات الاستخدام الخاصة بك لتتبع استهلاك الرموز المميزة عبر نقاط النهاية والنماذج.

إرشادات اختيار النموذج

اختر النماذج بناءً على متطلبات القدرة وقيود زمن الاستجابة. ابدأ بـ qwen3-4b للنماذج الأولية والاستعلامات البسيطة – فهو يستجيب بسرعة ويتعامل مع معظم مهام توليد النصوص بشكل كافٍ. قم بالترقية إلى نماذج أكبر مثل llama-3.3-70b أو deepseek-ai-DeepSeek-R1 عندما تحتاج إلى استدلال متقدم، أو توليد التعليمات البرمجية، أو اتباع تعليمات معقدة. تتطلب مهام الرؤية نماذج متعددة الوسائط مثل qwen3-vl-235b-a22b. يستخدم توليد الصوت نماذج كلام متخصصة. استعلم عن نقطة النهاية /api/v1/models برمجيًا للتحقق من التوفر في الوقت الفعلي – تقوم Venice بتدوير النماذج بناءً على الطلب وقدرة البنية التحتية.

الخاتمة

تزيل Venice API التعقيدات من تكامل الذكاء الاصطناعي. تحصل على توافق مع OpenAI دون قيود، وخصوصية دون تعقيد في التكوين، وتسعير مرن بدون فواتير مفاجئة. يعني نهج الاستبدال المباشر أنه يمكنك تقييم Venice جنبًا إلى جنب مع مزودك الحالي دون إعادة كتابة التعليمات البرمجية للتطبيق.

عند بناء تكاملات API – سواء كنت تختبر نقاط نهاية Venice، أو تصحح أخطاء تدفقات المصادقة، أو تدير تكوينات مزود متعددة – استخدم Apidog لتبسيط سير عملك. إنه يتعامل مع اختبار API المرئي، وتوليد الوثائق، وتعاون الفريق حتى تتمكن من التركيز على تقديم الميزات.

button