الانتقال إلى المحتوى الرئيسي
يُعدّ Venice AI بديلاً جاهزاً (drop-in) لـ OpenAI. نفس SDK ونفس الكود — ما عليك سوى تغيير سطرين. احصل على استدلال يعطي الأولوية للخصوصية، ونماذج بدون رقابة، وتسعير تنافسي.

الانتقال في سطرين

أنشئ مفتاحاً من venice.ai/settings/api أو اتّبع دليل مفتاح API.

متغيرات البيئة

تقرأ كثير من المكتبات والأدوات المتغيرين OPENAI_API_KEY وOPENAI_BASE_URL تلقائياً. قد يكفي تحديث متغيرات البيئة هذه فقط. لا تزال بعض الأدوات تستخدم OPENAI_API_BASE للإشارة إلى نفس عنوان URL.

النماذج

مرّر معرّف نموذج Venice، أو سمة (trait) مثل default أو most_uncensored، أو اسماً مألوفاً بأسلوب OpenAI لنماذج الدردشة والتضمين (embedding). تقوم Venice بربط أسماء نماذج الدردشة والتضمين الخاصة بـ OpenAI عبر ربط التوافق، أما نقاط النهاية الأخرى، بما فيها الصوت، فتتطلب معرّفات نماذج Venice. تُحلّ السمات دائماً إلى النموذج الحالي الذي يؤدي هذا الدور. انظر سمات النماذج. تصفّح الكتالوج الحيّ في نماذج النصوص والتسعير. لجولة إرشادية عبر أول طلب، راجع البدء السريع.

توافق الميزات

للاطلاع على خيارات الصور الأصلية التي تتجاوز نقطة النهاية المتوافقة مع OpenAI، انظر توليد الصور.

تنسيق البث

تستخدم تدفقات Chat Completions تنسيق الأجزاء (chunks) الخاص بـ OpenAI وتنتهي بـ data: [DONE]. يختلف أمران:
  • جزء الاستخدام. ينتهي كل تدفق بجزء استخدام قبل [DONE]، حتى عندما تكون قيمة stream_options.include_usage هي false. تكون مصفوفة choices فيه فارغة، ويحمل usage وكائن cost. يجب على العملاء الذين يقرؤون choices[0] في كل جزء تخطي الأجزاء التي لا تحتوي على اختيارات.
  • الأخطاء بعد بدء التدفق. تكون حالة HTTP قد أصبحت 200 بالفعل، لذا يصل الخطأ كحدث data: يحتوي على كائن error (message وtype وcode)، يليه data: [DONE]. عندما يكون النموذج مثقلًا، يتضمن الكائن أيضًا retry_after بالثواني.

ميزات حصرية لـ Venice

مرّر الخيارات الخاصة بـ Venice عبر extra_body بوصفها venice_parameters. البحث المدمج على الويب هو عادةً أول إضافة تحتاجها:
يتم تجاهل المفاتيح غير المعروفة داخل venice_parameters بدلًا من رفضها، لذا تحقّق من تهجئة كل مفتاح مقارنةً بـمرجع API. يغطي النمط نفسه الزحف على الويب (web scraping) والاقتباسات والشخصيات. إذا كان العميل لا يستطيع تغيير جسم الطلب، أضف لاحقة ميزة النموذج مثل default:enable_web_search=auto. كما تمتلك Venice واجهات API أصلية لـالفيديو والموسيقى واسترجاع الويب وx402 إلى جانب الواجهة المتوافقة مع OpenAI.

الأُطر (Frameworks)

تعمل معظم أُطر الذكاء الاصطناعي مع Venice بمجرد تغيير base URL:

LangChain

base_url في ChatOpenAI؛ check_embedding_ctx_length=False على OpenAIEmbeddings

Vercel AI SDK

baseURL في createOpenAI

LlamaIndex

api_base في العميل المتوافق مع OpenAI

CrewAI

متغير البيئة OPENAI_API_BASE

PydanticAI

نموذج متوافق مع OpenAI باستخدام base URL الخاص بـ Venice

Cursor

نقطة نهاية API مخصّصة في الإعدادات

Claude Code

توجيه Claude Code عبر Venice

Codex CLI

مزوّد النموذج في config.toml

Aider

متغير البيئة OPENAI_API_BASE
يمكنك الاطلاع على مزيد من وكلاء البرمجة والأدوات في وكلاء الذكاء الاصطناعي.

النماذج بدون رقابة

نماذج Venice الخاصة بدون رقابة لا تطبّق أي تصفية للمحتوى، مما يجعلها مناسبة لـ:
  • الكتابة الإبداعية بدون قيود
  • أبحاث الأمن والاختبار الهجومي (red teaming)
  • التحليل الصادق بدون أنماط الرفض
  • المعلومات الطبية والقانونية بدون إخلاءات مسؤولية إضافية
استخدم السمة most_uncensored أو معرّف نموذج حالي بدون رقابة من نماذج النصوص.

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

أنشئ مفتاح Venice API وابدأ الانتقال في دقائق