واجهة برمجة تطبيقات Venice AI: أول طلب في خمس دقائق
شغّل LLM بدون رقابة في أقل من خمس دقائق مع دليل البدء السريع لـ Venice AI API. استخدم نقاط النهاية المتوافقة مع OpenAI لإرسال النصوص، وبث الاستجابات، واستدعاء الدوال بأسعار شفافة حسب الاستخدام.
https://api.veniceapialternative.com/v1
عنوان URL الأساسي والمصادقة
ابدأ بإنشاء حساب في صفحة الحصول على مفتاح API. تحتاج فقط إلى بريد إلكتروني وكلمة مرور؛ لا يلزم بطاقة ائتمان للحصول على رصيد تجريبي بقيمة 0.50 دولار صالحًا لمدة سبعة أيام. يتم عرض مفتاح API الخاص بك فورًا بعد التسجيل ويمكن إعادة إنشائه في أي وقت، مما يلغي المفتاح القديم.
استخدم الرابط الأساسي https://api.veniceapialternative.com/v1 مع OpenAI SDKs الرسمية أو أي عميل متوافق مع OpenAI. اضبط مفتاح API الخاص بك كرمز حامل في رأس Authorization. نقطة النهاية venice ai api هذه تحل محل الرابط الأساسي الافتراضي لـ OpenAI في تكوين العميل الخاص بك.
الطلب الأول
أرسل طلب إكمال دردشة بسيطًا لاختبار الاتصال. معرف النموذج هو دائمًا uncensored. يعمل هذا النموذج مفتوح الأوزان على خوادم GPU لدينا وهو مضبوط للإجابة بدون رفض المحتوى للاستخدام القانوني للبالغين.
استبدل YOUR_API_KEY بمفتاحك الفعلي. تُرجع الاستجابة مخرجات نصية بناءً على الموجّه الخاص بك.
curl https://api.veniceapialternative.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [{"role": "user", "content": "Write a blunt product review of a cheap VPN."}]
}'
مثال مكتبة Python SDK
قم بتثبيت مكتبة OpenAI لـ Python وقم بتكوينها لاستخدام عنوان URL الأساسي الخاص بنا. يتيح لك ذلك الاستفادة من قواعد الشيفرة الموجودة التي تتوقع نقاط نهاية OpenAI.
from openai import OpenAI
client = OpenAI(base_url="https://api.veniceapialternative.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 SDK
في بيئات Node.js، استخدم حزمة openai. قم بتهيئة العميل بعنوان URL الأساسي المخصص ومفتاح API الخاص بك. يضمن ذلك توجيه جميع الطلبات عبر بنية venice ai api.
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.veniceapialternative.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);
الاستجابات المتدفقة
فعّل البث عن طريق تعيين stream: true في طلبك. تُرجع واجهة برمجة التطبيقات أحداثًا تُرسلها الخادم (SSE) لتسليم الرموز في الوقت الفعلي. هذا مفيد لواجهات الدردشة التي تحتاج إلى عرض النص أثناء إنشائه.
stream = 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)
حدود المعدل والقيود
يدعم نموذج uncensored نافذة سياق بحجم 100,000 رمز للموجّه والإكمال معًا. أنت مقيد بـ 300 طلب في الدقيقة لكل مفتاح API. يجب ألا تتجاوز أحجام الطلبات 8 ميجابايت.
تشمل الأخطاء الشائعة 401 (مفتاح غير صالح)، و402 (رصيد غير كافٍ)، و429 (تجاوز حد المعدل). قم بشحن رصيد مسبق الدفع بدءًا من 10 دولارات؛ لا تنتهي صلاحية الأرصدة أبدًا. لا توجد اشتراكات شهرية تقيد استخدامك.
مواصفات API
كل الحدود والميزات الفعلية للـ API في مكان واحد — راجعها قبل شحن الرصيد.
| البند | القيمة |
|---|---|
| صيغة API | متوافق مع OpenAI: يعمل أي SDK من OpenAI بتغيير base URL والمفتاح فقط |
| نقاط النهاية | POST /v1/chat/completions · GET /v1/models |
| معرّف النموذج | uncensored |
| المصادقة | Authorization: Bearer YOUR_KEY |
| Base URL | https://api.veniceapialternative.com/v1 |
| وضع JSON | response_format: {"type": "json_object"} |
| المعاملات | temperature, top_p, stop, seed, presence_penalty, frequency_penalty |
| نافذة السياق | 100,000 رمز (المدخلات والمخرجات معاً) |
| استدعاء الدوال | نعم — tools و tool_choice؛ الرد يتضمن tool_calls حتى أثناء البث؛ تُرسل النتائج كرسالة role: tool |
| البث المتدفق | نعم — server-sent events؛ آخر جزء يتضمن استهلاك الرموز |
| أقصى مخرجات | حتى ما تبقى من نافذة 100,000 رمزًا؛ max_tokens اختياري (بلا حد منفصل) |
| حجم الطلب | حتى 8 MB |
| الطلبات المتزامنة | حتى 8 في الوقت نفسه لكل مفتاح |
| ترويسات الرد | X-Request-Id, X-Balance-USD, X-RateLimit-Limit-Requests, X-RateLimit-Limit-Concurrency |
| حدّ المعدل | 300 طلب في الدقيقة لكل مفتاح |
| الصلاحية | الرصيد المدفوع لا تنتهي صلاحيته، بدون اشتراك |
| الفوترة | رصيد مسبق الدفع حسب الاستهلاك الفعلي؛ الأخطاء والرفض مجانية |
| مكافأة | +5% من $50، +10% من $100 |
| السعر | $0.25 لكل مليون رمز مدخلات · $1.00 لكل مليون رمز مخرجات |
| شحن الرصيد | USDT (TRC20) أو USDC (Base)، أي مبلغ صحيح من $10 إلى $500 |
| رصيد تجريبي مجاني | $0.50 لمدة 7 أيام، بدون بطاقة · مفتاح تجريبي: طلبان متوازيان، 60 طلبًا في الدقيقة؛ الحدود الكاملة (8 و300) بعد أول شحن |
| المفاتيح | مفتاح نشط واحد لكل حساب؛ المفتاح الجديد يحل محل القديم |
| تسجيل الدخول | Google أو البريد الإلكتروني وكلمة المرور |
| المحتوى | محتوى البالغين مسموح؛ يُرفض أي محتوى جنسي يتعلق بالقاصرين |
رموز الأخطاء
تصل الأخطاء بصيغة JSON مع type ثابت؛ الطلبات الفاشلة أو المرفوضة لا تُحتسب.
| الرمز | النوع | المعنى |
|---|---|---|
400 | bad_request | JSON غير صالح أو رسائل فارغة أو معامل خاطئ أو تجاوز نافذة السياق |
401 | missing_key · invalid_key · key_revoked | لا يوجد مفتاح أو المفتاح خاطئ أو تم استبداله |
402 | no_credit | الرصيد فارغ — اشحن وتستأنف الطلبات فوراً |
403 | content_blocked | محتوى جنسي يتعلق بقاصرين — مرفوض دون احتساب |
404 | not_found | نقطة نهاية غير معروفة |
413 | request_too_large | جسم الطلب أكبر من 8 MB |
429 | rate_limited · concurrency | تجاوز 300 في الدقيقة أو 8 متزامنة — انتظر ثم أعد المحاولة |
503 | upstream_busy | النموذج مشغول — أعد المحاولة بعد ثوانٍ |
أسئلة وأجوبة
هل هذه هي واجهة برمجة تطبيقات Venice.ai الرسمية؟
لا. هذه خدمة مستقلة تستضيف نموذجًا مفتوح الأوزان بدون رقابة. وهي غير تابعة أو بائع تجزئة لمنصة Venice.ai الرئيسية أو نماذج أي مورد آخر.
هل تدعم واجهة برمجة التطبيقات هذه إنشاء الصور أو الصوت؟
لا. هذه واجهة برمجة تطبيقات لإكمال الدردشة النصية فقط. لا تدعم التضمينات، أو إنشاء الصور، أو الصوت، أو الفيديو، أو الضبط الدقيق.
ماذا يحدث إذا انتهت صلاحية رصيدك التجريبي؟
ينتهي صلاحية رصيدك التجريبي بعد سبعة أيام. يمكنك شحن الرصيد بالعملات المشفرة (USDT أو USDC) بدءًا من 10 دولارات. لا تنتهي صلاحية أرصدة ما قبل الدفع أبدًا، ويمكنك إعادة إنشاء مفتاح API الخاص بك في أي وقت.
مفتاحك على بُعد نموذج واحد
أنشئ حسابًا، وانسخ المفتاح، وغير عنوان URL الأساسي. هذا هو الإعداد بأكمله.