AR ▾

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

https://api.veniceapialternative.com/v1

veniceapialternative.com

بديل API فينيس بايثون: إعداد OpenAI SDK

يمكنك استخدام حزمة الـ Python الرسمية من OpenAI مع هذا الـ API عن طريق تغيير الـ Base URL والمفتاح واسم النموذج. فيما يلي كود يعمل لكل مهمة شائعة.

تم التحديث

شريط من كتل الكود يتدفق من طرفي إلى خادم سحابي، يوضح إعداد API بايثون

نقاط رئيسية

  • ثبّت الحزمة openai، اضبط base_url على https://api.veniceapialternative.com/v1 والنموذج إلى uncensored.
  • يعمل البث المتدفق، واستدعاء الأدوات، ووضع JSON عبر استدعاءات الـ SDK القياسية.
  • حافظ على العمل المتوازي عند أو أقل من 8 طلبات متزامنة على المفتاح الكامل (2 على مفتاح التجربة).
  • يعني 429 أن الحالة rate_limited، أو تجاوز حدّ التوازي، أو حمل زائد مؤقت؛ تراجع وأعد المحاولة.

التثبيت وإجراء أول استدعاء

لإعداد بديل venice api python، لا تحتاج إلى مكتبة خاصة. الخدمة تتحدث بتنسيق دردشة OpenAI، لذا تعمل الحزمة القياسية. ثبّتها باستخدام pip install openai، ثم احصل على مفتاح. يمكن للمستخدمين الجدد الحصول على $0.50 من رصيد تجريبي مجاني في صفحة مفتاح API بعد تسجيل الدخول باستخدام Google أو باستخدام البريد الإلكتروني وكلمة المرور. لا حاجة لبطاقة.

احفظ المفتاح في متغير بيئة بدلاً من ملف المصدر الخاص بك. ثم أنشئ عميلاً باستخدام نقطة النهاية الأساسية واستدع النموذج uncensored:

import os
from openai import OpenAI

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

resp = client.chat.completions.create(
    model="uncensored",
    messages=[
        {"role": "system", "content": "You are a concise writing assistant."},
        {"role": "user", "content": "Give me three opening lines for a noir story."},
    ],
    temperature=0.8,
)

print(resp.choices[0].message.content)
print(resp.usage)

ترسل الحزمة Authorization: Bearer <key> نيابةً عنك. يعرض الكائن usage رموز (token) الموجّه والإكمال، والتي ستستخدمها لاحقاً لتتبع التكلفة. إذا فشل الطلب بخطأ مصادقة، تحقق من أن المفتاح لا يحتوي على سطر جديد في نهايته وأن نقطة النهاية الأساسية تنتهي بـ /v1.

تُمرَّر معاملات درجة الحرارة وtop_p وstop وseed، بالإضافة إلى عقوبات التكرار والوجود، إلى النموذج، مما يتيح لك ضبط أخذ العينات بنفس الطريقة التي تتعامل بها مع واجهات أخرى. اترك max_tokens فارغاً إذا أردت أن يستخدم النموذج المساحة المتبقية في نافذة السياق، أو اضبطه عندما تريد تحديد حدّ صارم لطول الرد وتكلفته.

فحص الاتصال عبر نقطة النهاية الخاصة بالنماذج

قبل أن تبدأ في بناء أي شيء، تأكد من إمكانية الوصول إلى نقطة النهاية. طريقة GET الثانية المدعومة، GET /v1/models، تعرض ما يمكن للمفتاح استخدامه:

import os
from openai import OpenAI

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

for m in client.models.list():
    print(m.id, m.id == "uncensored")

يجب أن ترى uncensored. هذا هو معرف النموذج الوحيد، وهي القيمة التي يجب تمريرها كـ model في كل طلب. إذا كنت تنقل تطبيقاً كان يختار بين عدة أسماء نماذج، استبدل منطق الاختيار بثابت. لا يوجد شيء آخر للاختيار بينه.

المرجع الكامل للمعاملات موجود في صفحة التوثيق. يتم دعم دردشة النصوص فقط: لا صور، ولا صوت، ولا تضمينات (embeddings)، ولا تدريب دقيق (fine-tuning)، لذا قم بإزالة تلك المكالمات من أي كود تنقله.

استجابات البث المتدفق

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

import os
from openai import OpenAI

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

stream = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Describe a rainy harbor town in 120 words."}],
    stream=True,
)

for chunk in stream:
    if chunk.choices and chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="", flush=True)
    if getattr(chunk, "usage", None):
        print("\n", chunk.usage)

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

استدعاء الدوال ووضع JSON

يتبع استدعاء الأدوات الهيكل الخاص بـ OpenAI. تصف الدوال في tools، ويعيد النموذج tool_calls، وتشغل الدالة وترسل النتيجة مرة أخرى مع role: "tool":

import json
import os
from openai import OpenAI

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

tools = [{
    "type": "function",
    "function": {
        "name": "roll_dice",
        "description": "Roll a die with the given number of sides",
        "parameters": {
            "type": "object",
            "properties": {"sides": {"type": "integer"}},
            "required": ["sides"],
        },
    },
}]

messages = [{"role": "user", "content": "Roll a twenty-sided die for the next encounter."}]
first = client.chat.completions.create(
    model="uncensored", messages=messages, tools=tools, tool_choice="auto"
)
msg = first.choices[0].message

if msg.tool_calls:
    call = msg.tool_calls[0]
    args = json.loads(call.function.arguments)
    result = {"value": 14, "sides": args["sides"]}
    messages.append(msg)
    messages.append({"role": "tool", "tool_call_id": call.id, "content": json.dumps(result)})
    final = client.chat.completions.create(model="uncensored", messages=messages, tools=tools)
    print(final.choices[0].message.content)

قم دائماً بتحليل function.arguments باستخدام try/except في كود الإنتاج، لأن النموذج قد يُخرج أحياناً JSON غير صالح. يساعد وضع JSON عندما تريد مخرجات منظمة دون استخدام أدوات:

import json
import os
from openai import OpenAI

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

r = client.chat.completions.create(
    model="uncensored",
    response_format={"type": "json_object"},
    messages=[
        {"role": "system", "content": "Reply with a JSON object with keys name, mood and hook."},
        {"role": "user", "content": "Invent a tavern keeper for a fantasy campaign."},
    ],
)
print(json.loads(r.choices[0].message.content))

أخبر النموذج في الموجّه المفاتيح التي تريدها. يجعل وضع JSON الإخراج JSON صالحاً، لكنه لا يستطيع تخمين مخططك.

معالجة أخطاء 429 وحدود المعدل

المفتاح الكامل يسمح بـ 8 طلبات متزامنة و300 طلب في الدقيقة. يسمح مفتاح التجربة بـ 2 طلب متزامن و60 طلب في الدقيقة. بعد تجاوز حدّ، تحصل على HTTP 429، ويخبرك رمز الخطأ بأي منهما:

  • rate_limited: عدد كبير جداً من الطلبات في الدقيقة. قلل السرعة.
  • concurrency: عدد كبير جداً من الطلبات قيد التنفيذ. انتظر حتى ينتهي بعضها.
  • 429 مع رأس Retry-After: 5: حمل زائد مؤقت. انتظر 5 ثوانٍ وأعد المحاولة.

يعيد الـ SDK المحاولة بضع مرات افتراضياً ويحترم Retry-After. لأي شيء أكثر تعقيداً، أضف غلافك الخاص واقرأ رؤوس حدّ المعدل. يمكنك الوصول إلى الاستجابة الخام من خلال with_raw_response:

import os
import time
import openai
from openai import OpenAI

client = OpenAI(
    base_url="https://api.veniceapialternative.com/v1",
    api_key=os.environ["UNCENSORED_API_KEY"],
    max_retries=0,
)

def ask(prompt, attempts=4):
    for n in range(attempts):
        try:
            raw = client.chat.completions.with_raw_response.create(
                model="uncensored",
                messages=[{"role": "user", "content": prompt}],
            )
            print("balance:", raw.headers.get("X-Balance-USD"),
                  "request id:", raw.headers.get("X-Request-Id"))
            return raw.parse().choices[0].message.content
        except openai.RateLimitError as e:
            wait = int(e.response.headers.get("Retry-After", 2 ** n))
            time.sleep(wait)
    raise RuntimeError("still rate limited after retries")

print(ask("Name three plot twists for a heist story."))

سجّل X-Request-Id مع كل فشل. إذا تواصلت مع الدعم، فإن هذا المعرف يسمح لهم بإيجاد الطلب الدقيق. يعطي الرأس X-Balance-USD الرصيد المتبقي دون طلب إضافي. الطلبات الفاشلة والمرفوضة لا تُفرض عليها رسوم.

تشغيل الطلبات بالتوازي دون تجاوز الحد

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

import asyncio
import os
from openai import AsyncOpenAI

client = AsyncOpenAI(
    base_url="https://api.veniceapialternative.com/v1",
    api_key=os.environ["UNCENSORED_API_KEY"],
)
gate = asyncio.Semaphore(6)

async def summarize(text):
    async with gate:
        r = await client.chat.completions.create(
            model="uncensored",
            messages=[{"role": "user", "content": "Summarize in one sentence: " + text}],
            max_tokens=80,
        )
        return r.choices[0].message.content

async def main():
    docs = ["First long text ...", "Second long text ...", "Third long text ..."]
    for line in await asyncio.gather(*(summarize(d) for d in docs)):
        print(line)

asyncio.run(main())

السرعة مهمة أيضاً لحدّ الدقيقة. عند 6 عملاء متوازيين و4 ثوانٍ لكل طلب، ترسل حوالي 90 طلباً في الدقيقة، وهو أقل بكثير من 300. إذا كانت طلباتك سريعة، أضف تأخيراً صغيراً أو token bucket حتى لا تتجاوز الحد في دفعات.

نقل مشروع Python موجود

معظم عمليات الترحيل أصغر مما يتوقعه الناس. إذا كان كودك يبني بالفعل عميل OpenAI(...)، فستحتاج لتغيير وسطين من وسيطات الدالة الإنشائية (constructor) وسلسلة نصية واحدة. إذا كنت تقرأ الإعدادات من متغيرات البيئة، يمكنك غالباً تجنب تعديل الكود تماماً: تقرأ حزمة openai المتغيرين OPENAI_API_KEY و OPENAI_BASE_URL، لذا فإن ضبط هذين المتغيرين في الـ shell أو في ملف .env يوجّه البرنامج بأكمله نحو نقطة النهاية الجديدة.

ثم ابحث في مشروعك عن هذه العناصر، لأنها المصادر المعتادة للأعطال:

  • أسماء النماذج الثابتة (Hard-coded). استبدل كل اسم قديم بـ uncensored. يبحث grep عن model= عن معظمها.
  • الاستدعاءات لنقاط نهاية أخرى. لا يوجد مكافئ هنا لاستدعاءات الصور أو الصوت أو التضمين (embedding) أو الضبط الدقيق (fine-tuning). وجّهها إلى خدمة تقدمها، أو احذفها.
  • الميزات الخاصة بمزود الخدمة. حقول الطلب الإضافية أو الرؤوس المخصصة (custom headers) الخاصة بمزودك القديم قد تسبب أخطاء. احذفها لتحويلها إلى تنسيق OpenAI القياسي.
  • ميزانيات الرموز (Token budgets). النافذة هي 100,000 رمز للموجّه (prompt) والإكمال (completion) معاً. إذا كنت قد قصصت السجل ليتناسب مع نافذة أصغر، يمكنك الآن الاحتفاظ بالمزيد، لكن راقب التكلفة، لأن كل رسالة يتم الاحتفاظ بها تُدفع ثمنها مرة أخرى في كل دورة.

تستحق الموجّهات (Prompts) إعادة الاختبار. قد يعطي الموجّه النظامي نبرة مختلفة على نموذج آخر، لذا شغّل أهم عشرة موجّهات لديك وقارن المخرجات بما تتوقعه قبل النشر.

المشاكل الشائعة وحلولها

قائمة قصيرة بالأخطاء التي تظهر غالباً عند توصيل نقطة نهاية متوافقة مع OpenAI من Python:

  • خطأ 404 في المكالمة الأولى. يفتقد عنوان base URL إلى /v1، أو يحتوي على جزء مسار إضافي. يجب أن يكون بالضبط https://api.veniceapialternative.com/v1.
  • خطأ 401 أو خطأ المصادقة. المفتاح غير صحيح، أو لا يزال محاطاً بعلامات اقتباس من سطر .env المنسوخ، أو لم يتم تصديره إلى الـ shell الذي يشغل Python.
  • تعليق الطلب (hang) مع المدخلات الكبيرة. الحد الأقصى لحجم الحمولة (body) هو 8 MB. لصق ملف ضخم في الموجّه (prompt) قد يتجاوز هذا الحد قبل أن تصل إلى حد الرموز. قسّم النص.
  • أخطاء 429 عشوائية أثناء الاختبار. مع مفتاح التجربة، لديك طلبان متزامنان فقط. قد يؤدي مشغل الاختبار الذي يطلق خمسة طلبات في وقت واحد إلى تجاوز الحد. شغّل الاختبارات بشكل تسلسلي، أو قم بشحن الرصيد (top up) واستخدم مفتاحاً كاملاً.
  • إجابات مقطوعة. تحقق من finish_reason. قيمة length تعني أن المخرج وصل إلى إعداد max_tokens الخاص بك أو ملأ نافذة السياق.
  • نتائج مختلفة من تشغيل لآخر. مرر seed ودرجة temperature منخفضة إذا كنت تحتاج إلى مخرجات قابلة للتكرار للاختبارات.

إذا بدا شيء ما خاطئاً بعد ذلك، أرسل قيمة X-Request-Id إلى الدعم مع وقت الاستدعاء.

تقدير التكلفة في الكود

السعر هو $0.15 لكل مليون رمز مدخل و $0.50 لكل مليون رمز مخرج. مساعد صغير يحول أي كتلة استخدام إلى دولارات:

import os
from openai import OpenAI

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

def cost_usd(usage):
    return (usage.prompt_tokens * 0.15 + usage.completion_tokens * 0.50) / 1_000_000

r = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Write a limerick about a lighthouse."}],
)
print(round(cost_usd(r.usage), 6))

الطلب الذي يحتوي على 2,000 رمز موجّه و500 رمز إكمال يعيد 0.00055. نفّذ 1,000 منها وستنفق $0.55. رصيد التجربة بقيمة $0.50 يغطي حوالي 909 طلبات من هذا النوع. بعد انتهاء التجربة، تبدأ شحنات الرصيد من $20 ولا ينتهي الرصيد؛ وتعرض صفحة التسعير فئات المكافآت. إذا كان تطبيقك مستمدًا من مشروع روبوت دردشة يحتوي على بعض المزالق، فإن المقال حول أخطاء API الشائعة يغطي عدة نقاط تنطبق هنا أيضًا.

أسئلة وأجوبة

ما هي حزمة Python التي أحتاجها؟

الحزمة الرسمية openai. ثبّتها باستخدام pip، اضبط base_url على https://api.veniceapialternative.com/v1، واستخدم النموذج uncensored. لا يلزم أي مكتبة عميل أخرى.

هل يعمل البث المتدفق (streaming) مع الـ SDK؟

نعم. مرر stream=True وتكرّر عبر القطع. يُبلغ عن الاستخدام في نهاية البث.

لماذا أحصل على خطأ 429؟

إما أنك تجاوزت حد الطلبات في الدقيقة (rate_limited)، أو كان لديك طلبات كثيرة مفتوحة في وقت واحد (concurrency)، أو كانت الخدمة مثقلة مؤقتاً وأرسلت Retry-After: 5. تراجع وأعد المحاولة.

كم عدد الطلبات المتزامنة (parallel requests) التي يمكنني تشغيلها؟

المفتاح الكامل يسمح بـ 8 طلبات متزامنة و300 في الدقيقة. المفتاح التجريبي يسمح بـ 2 طلب متزامن و60 في الدقيقة.

هل يمكنني استخدام LangChain أو أدوات أخرى متوافقة مع OpenAI؟

أي عميل يتيح لك ضبط قاعدة URL ومفتاح متوافقين مع OpenAI سيعمل. استخدم نفس قاعدة URL واسم النموذج uncensored.

مفتاحك على بُعد استمارة واحدة

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

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