قم بدمج Venice AI API في دقائق

إعداد عنوان URL الأساسي والمصادقة

تعيش واجهة برمجة التطبيقات عند https://api.veniceaiapi.com/v1. تقوم بالمصادقة باستخدام مفتاح API واحد مُمرَّر في Authorization رأس.

سجّل عبر Google أو البريد الإلكتروني للحصول على مفتاحك فوراً. لا يتطلب الأمر رقم هاتف. استخدم المفتاح مع أي حقيبة SDK متوافقة مع OpenAI عن طريق ضبط عنوان URL الأساسي.

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

معرف النموذج الذي يجب إرساله هو "uncensored". إنه نموذج مفتوح الأوزان مُضبط للإجابة دون رفض المحتوى للاستخدام البالغ القانوني.

• URL الأساسي: https://api.veniceaiapi.com/v1
• رأس المصادقة: Authorization: Bearer YOUR_API_KEY
• النموذج: uncensored

يمكنك اختبار الاتصال باستخدام طلب GET بسيط إلى /v1/models. يؤكد ذلك أن مفتاحك يعمل قبل إرسال حمولات ثقيلة.

نقطة نهاية /v1/chat/completions

أرسل مطالبات نصية إلى POST /v1/chat/completions واستخراج استجابات نصية. يتعامل هذا الطرف مع جميع تفاعلات الدردشة القياسية.

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

الحد الأقصى الافتراضي للإخراج هو 2,048 رمزًا. يمكنك زيادته حتى 16,000 رمز لكل طلب. تسمح نافذة السياق الإجمالية بـ 100,000 رمز للسياق والإكمال معًا.

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

معلمات النموذج: درجة الحرارة، Top-P، والبذرة

تحكّم في عشوائية المخرجات باستخدام معايير نماذج اللغة الكبيرة (LLM) القياسية. اضبط temperature لضبط الإبداع. تجعل القيم الأقل الاستجابات أكثر حتمية وتركيزاً.

استخدام top_p للعينة النواة. هذا يحد النموذج للنظر في النسبة المئوية الأعلى من كتلة الاحتمال. يساعد في منع المخرجات المتكررة أو غير المنطقية.

تعيين seed لإنتاج نتائج قابلة لإعادة الإنتاج. هذا مفيد لتصحيح الأخطاء أو اختبار اختلافات المطالبات المحددة. يمكنك أيضًا استخدام stop تسلسلات لإيقاف التوليد مبكراً.

تشمل المعلمات المدعومة الأخرى presence_penalty و frequency_penalty. تساعد هذه الخيارات في تنوع الرموز في المحادثات الطويلة.

عدّل هذه الإعدادات لتناسب حالة الاستخدام. يستفيد لعب الأدوار من درجة حرارة أعلى. قد تحتاج البرمجة إلى قيم أقل.

استجابات البث مع أحداث الإرسال من الخادم

فعّل البث عن طريق تعيين stream: true في طلبك. تُعيد واجهة برمجة التطبيقات أحداث الإرسال الخادم (SSE) بدلاً من كائن JSON واحد.

يحتوي كل جزء على محتوى نصي جزئي. يتيح لك ذلك عرض النتائج في الوقت الفعلي للمستخدمين. يحسن بشكل كبير من زمن الاستجابة المُدرَك للاستجابات الطويلة.

تتضمن الشريحة النهائية إحصائيات إجمالي استخدام الرموز الشاردية. يمكنك تتبع استهلاك رصيدك بدقة وفي الوقت الفعلي.

التعامل مع أخطاء التدفق بسلاسة. قد تؤدي انقطاعات الشبكة إلى اقتطاع الاستجابة. يمكنك استئناف أو إعادة محاولة الطلب إذا لزم الأمر.

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

استخدم استدعاء الوظائف لتكامل واجهة برمجة التطبيقات مع منطق الخلفية الخاص بك. عرّف الأدوات في طلبك وسيعيد النموذج معاملات JSON منظمة.

تعيين response_format: {"type": "json_object"} لإجبار إخراج JSON صارم. هذا مثالي لتحليل البيانات في تطبيقك.

يعمل استدعاء الوظائف بالتزامن مع التدفق. يمكنك تلقي بيانات هيكلية في الوقت الفعلي. يتيح ذلك تفاعلات متعددة الخطوات معقدة.

يفهم النموذج تعريفات الأدوات وينفذها وفقاً لذلك. أنت تتعامل مع منطق تنفيذ الأداة في كودك.

هذه الميزة تجعل الـ API مناسبًا لبناء الوكلاء أو عمليات سير العمل الآلية.

حدود المعدلات وقيود الرموز

يُقتصر كل مفتاح API على 300 طلب في الدقيقة. يمكنك إجراء 8 طلبات متزامنة في الوقت نفسه. هذا يمنع التقلبات المفاجئة من إغراق النظام.

حجم جسم الطلب الأقصى هو 8 ميجابايت. تأكد من أن حمولاتك تتناسب ضمن هذا الحد. تستهلك نوافذ السياق الكبيرة هذا الحصة بسرعة.

تشمل الأخطاء الشائعة 401 للمفاتيح غير الصالحة و402 لقصور الرصيد. يشير خطأ 429 إلى أنك تجاوزت حد معدل الطلب.

الاستردادات غير متوفرة للائتمان. ومع ذلك، تُصلح الأخطاء مثل الشحنات المزدوجة عبر الدعم. لا تنتهي صلاحية الائتمان الخاص بك.

السعر هو $0.15 لكل مليون رمز إدخال و $0.50 لكل مليون رمز إخراج. الإيداعات بالعملات المشفرة فقط من $20 إلى $500.

cURL

Copycurl https://api.veniceaiapi.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Return status as json"}]
  }'

Python

Copyfrom openai import OpenAI

client = OpenAI(base_url="https://api.veniceaiapi.com/v1", api_key="YOUR_KEY")

resp = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Summarise this thread without softening it."}],
)
print(resp.choices[0].message.content)

Node.js

Copyimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.veniceaiapi.com/v1", apiKey: process.env.API_KEY });

const resp = await client.chat.completions.create({
  model: "uncensored",
  messages: [{ role: "user", content: "Draft a villain monologue for my game." }],
});
console.log(resp.choices[0].message.content);

التدفق

Copystream = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Tell the story in second person."}],
    stream=True,
)
for chunk in stream:
    if chunk.choices and chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="", flush=True)