AR ▾

بديل واجهة AI API بدون رقابة للمطورين

https://api.veniceapialternative.com/v1

veniceapialternative.com

نقطة نهاية واجهة برمجة تطبيقات Venice AI: التحويل إلى عنوان URL أساسي آخر

إذا كان الكود الخاص بك يشير إلى نقطة نهاية Venice AI API وترغب في تجربة مزود آخر، فإن التغيير بسيط: تغيير في عنوان URL الأساسي، والمفتاح، ومعرف النموذج. توضح هذه الصفحة ما يجب تعديله، وما يجب اختباره، وما الذي يتصرف بشكل مختلف بعد ذلك.

تم التحديث

قابس كابل ينتقل بين كتلتي خادم، يوضح تبديل عنوان URL الأساسي

نقاط رئيسية

  • تغطي التعديلات الأربعة معظم عمليات الهجرة: عنوان URL الأساسي، ومفتاح API، ومعرف النموذج، ومعالجة الرصيد.
  • عنوان URL الأساسي الجديد هو https://api.veniceapialternative.com/v1 ومعرف النموذج هو uncensored.
  • ثلاث نقاط نهاية مدعومة: إكمال الدردشة، الاستجابات والنماذج.
  • اختبر مع تجربة الـ $0.50 قبل توجيه حركة المرور الفعلية.

الإجابة المختصرة: أربع تعديلات

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

  1. عنوان URL الأساسي: اضبطه على https://api.veniceapialternative.com/v1.
  2. مفتاح API: أنشئ واحداً على صفحة مفتاح API وأرسله كـ Authorization: Bearer <key>.
  3. معرف النموذج: استخدم uncensored. يوجد نموذج واحد فقط، لذا لا توجد قائمة نماذج لربطها.
  4. فحوصات الرصيد: اقرأ رأس X-Balance-USD، أو اتصل بـ GET /v1/balance.

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

قبل التعديل: ابحث عن كل مكان توجد فيه نقطة النهاية

نادراً ما يكون عنوان URL الأساسي موجوداً في ملف واحد فقط. ابحث في مستودعك عن اسم المضيف القديم، عن سلسلة النموذج القديمة، وعن متغير البيئة الذي يحتوي على المفتاح. الأماكن الشائعة للإخفاء هي منشئات SDK، ملفات .env، أسرار Docker أو CI، تكوين الواجهة الأمامية وخدمات الخلفية التي كُتبت بشكل منفصل عن التطبيق الرئيسي.

عادة مفيدة هي نقل القيم الثلاث إلى متغيرات البيئة أولاً، ثم الترحيل. هذا يجعل التبديل تغييراً في وقت النشر ويعطيك إمكانية التراجع في سطر واحد.

export LLM_BASE_URL="https://api.veniceapialternative.com/v1"
export LLM_API_KEY="YOUR_KEY"
export LLM_MODEL="uncensored"

كود لـ Python وNode وcurl

Python (openai SDK)

import os
from openai import OpenAI

client = OpenAI(
    base_url=os.environ.get("LLM_BASE_URL", "https://api.veniceapialternative.com/v1"),
    api_key=os.environ["LLM_API_KEY"],
)

resp = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Say hello in five words."}],
)
print(resp.choices[0].message.content)

Node.js

import OpenAI from "openai";

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

const resp = await client.chat.completions.create({
  model: "uncensored",
  messages: [{ role: "user", content: "Say hello in five words." }],
});
console.log(resp.choices[0].message.content);

curl

curl -i https://api.veniceapialternative.com/v1/chat/completions \
  -H "Authorization: Bearer $LLM_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"uncensored","messages":[{"role":"user","content":"Say hello in five words."}]}'

تُطبع المعلمة -i رؤوس الاستجابة، وهي الطريقة التي ترى بها X-Request-Id و X-Balance-USD في المكالمة الأولى.

ما يظل كما هو، وما لا يظل

شكل الطلب مألوف: messages مع الأدوار، stream، tools، tool_choice، response_format لوضع JSON، ومعلمات أخذ العينات temperature، top_p، stop، seed والعقوبات. يستخدم البث المتدفق SSE مع الاستخدام في النهاية، وتعود نتائج الأداة كرسائل role: "tool".

العنصرهنا
نقاط النهايةPOST /v1/chat/completions، POST /v1/responses، GET /v1/models
معرّف النموذجuncensored (نموذج واحد)
نافذة السياق100,000 رمز، الموجّه بالإضافة إلى الإكمال
الحد الأقصى لحجم جسم الطلب8 MB
الأنماطالنص فقط: لا صور، صوت، فيديو، تضمينات أو ضبط دقيق

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

معالجة الحدود والأخطاء بشكل مختلف

المفتاح الكامل يسمح بـ 8 طلبات متزامنة و300 طلب في الدقيقة. يسمح مفتاح التجربة بـ 2 طلب متزامن و60 طلب في الدقيقة. عند تجاوز أي من هذين الحدّين، تحصل على استجابة HTTP 429، مع رمز الخطأ rate_limited للطلبات في الدقيقة أو concurrency للطلبات المتزامنة. تعني استجابة 429 مع الرأس Retry-After: 5 وجود حمل زائد مؤقت: انتظر وأعد المحاولة.

لاحظ أن الطلب المتدفق يحتفظ بمكان التزامن الخاص به حتى ينتهي البث. إذا كان تكاملك القديم يطلق عشرات المكالمات المتزامنة، ضع قفل عدّاد (semaphore) بقيمة 8 أو أقل أمام العميل.

import time, random
from openai import OpenAI, RateLimitError

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

def ask(prompt, tries=4):
    for i in range(tries):
        try:
            r = client.chat.completions.create(
                model="uncensored",
                messages=[{"role": "user", "content": prompt}],
            )
            return r.choices[0].message.content
        except RateLimitError:
            time.sleep(5 + random.random() * i)
    raise RuntimeError("still rate limited")

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

البث المتدفق واستدعاء الدوال بعد التحويل

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

from openai import OpenAI

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

stream = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "List three uses of a message queue."}],
    stream=True,
    stream_options={"include_usage": True},
)
for chunk in stream:
    if chunk.choices and chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="")
    if chunk.usage:
        print("\n", chunk.usage)

يتبع استدعاء الدوال نفس التدفق الذي تعرفه بالفعل. تمرر tools وtool_choice اختياريًا، ويعيد النموذج tool_calls (مبثّثًا على أجزاء عند تفعيل البث المتدفق)، وتشغّل الدالة، ثم ترسل النتيجة مرة أخرى كرسالة role: "tool". يعمل وضع JSON مع response_format: {"type": "json_object"}. تحقق دائمًا من صحة الـ JSON المفسر في الكود الخاص بك، لأن أي نموذج لا يضمن مخططًا محددًا.

المشاكل الشائعة بعد التحويل

  • فشل المصادقة. تحقق من إرسال المفتاح كرمز Bearer وأنك نسخت السلسلة كاملة. لن يعمل مفتاح من المزود القديم هنا.
  • أخطاء "غير موجود". يجب أن ينتهي عنوان URL الأساسي بـ /v1. إذا ألصقت المسار الكامل /chat/completions في SDK يضيفه تلقائيًا، فسيكون المسار خاطئًا.
  • نموذج غير معروف. أي سلسلة نموذج بخلاف uncensored تعتبر خاطئة. ابحث عن الأسماء الثابتة في ملفات التكوين والاختبارات.
  • موجات من أخطاء 429. حدّ التوازي ليتوافق مع قدرة المفاتيح من نوع مفتاحك، واحترم رأس Retry-After.
  • تكلفة غير متوقعة. تُحسب سجلات الدردشة الطويلة كمدخلات في كل خطوة. قم بتقليصها.

إذا بدا شيء ما غير صحيح، أرسل قيمة X-Request-Id من الاستجابة إلى صفحة الاتصال في صفحة الدعم. إنها تحدد الطلب بدقة وتوفر الوقت من الجانبين.

قائمة التحقق من التحويل والاختبار

اعمل على هذه الخطوات بالترتيب. كل خطوة هي تغيير صغير وقابل للعكس.

  1. احصل على تجربة بقيمة $0.50 من صفحة مفتاح API. لا يتطلب بطاقة ويستمر لمدة 7 أيام.
  2. نفّذ استدعاء curl المذكور أعلاه وتأكد من الاستجابة والرؤوس.
  3. حوّل مسار كود غير حرج واحد إلى عنوان URL الأساسي الجديد والمفتاح الجديد.
  4. أعد تشغيل عينة من الموجّهات الحقيقية وقارن جودة المخرجات وطولها وزمن الاستجابة بالعين المجردة.
  5. تحقق من usage في الاستجابات واضربها في حجمك بمعدل $0.15 لكل مليون رمز مدخل و$0.50 لكل مليون رمز مخرج.
  6. أضف تنبيه رصيد على X-Balance-USD.
  7. قم بشحن الرصيد (من $20، مع مكافآت من $50) وحوّل باقي حركة المرور.

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

تصف الوثائق كل نقطة نهاية ورأس. يغطي صفحتنا حول بديل واجهة Venice كيفية مقارنة المنتج، ويظهر صفحة الأسعار مبالغ الشحن، والمكافآت، وطرق الدفع. الموجّهات المرسلة إلى API لا تُستخدم للتدريب، والرصيد لا ينتهي، لذا فإن شحن الرصيد للاختبار لا يحمل موعد انتهاء.

الأسئلة والأجوبة

ما هو عنوان URL الأساسي؟

استخدم https://api.veniceapialternative.com/v1 مع أي عميل متوافق مع OpenAI، وأرسل مفتاحك كرمز Bearer.

ما هو معرف النموذج الذي يجب أن أرسله؟

أرسل uncensored. هناك نموذج واحد، لذا لا يوجد شيء لربطه من أسماء النماذج القديمة.

كيف أتحقق من رصيدي؟

اقرأ رأس الاستجابة X-Balance-USD، أو اتصل بـ GET /v1/balance، أو استخدم نقطة نهاية GET /v1/dashboard/billing/credit_grants بأسلوب OpenAI.

هل يمكنني استدعاء نقاط نهاية الصور أو التضمين؟

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

مفتاحك على بُعد نموذج تعبئة واحد

أنشئ حساباً، وانسخ المفتاح، ثم غيّر عنوان URL الأساسي. هذا هو الإعداد الكامل.

احصل على مفتاح API