AR ▾

Open AI API Python: استخدم SDK الخاص بـ OpenAI مع النموذج الخاص بنا

كابل على شكل ثعبان مُوصّل بخادم مع فقاعات دردشة، يُمثل استدعاء بايثون لواجهة API

لكتابة كود Open AI API Python، لا تحتاج إلى مكتبة خاصة. تعمل الحزمة الرسمية openai مع هذه الخدمة بمجرد ضبط عنوان URL الأساسي ومفتاح مختلف، ومع معرف النموذج uncensored. فيما يلي دليل كامل مع أمثلة قابلة للنسخ واللصق.

تم التحديث

نقاط رئيسية

  • قم بتثبيت openai، ثم مرر base_url و api_key إلى العميل؛ لن يتغير أي شيء آخر في الكود الخاص بك.
  • يعمل البث المتدفق، ووضع JSON واستدعاء الدوال جميعها عبر نفس طرق الـ SDK.
  • التقط RateLimitError وأعد المحاولة؛ الحدود هي 300 طلب في الدقيقة و8 طلبات متزامنة لمفتاح كامل.
  • التكلفة هي $0.15 لكل مليون رمز مدخل و $0.50 لكل مليون رمز مخرج، وتُحسب فقط للطلبات الناجحة.

التثبيت وإجراء أول طلب

تحتاج إلى Python 3.9 أو أحدث ووحدة SDK الرسمية. أنشئ مفتاح API أولاً من صفحة المفاتيح؛ يمكن للحسابات الجديدة المطالبة برصيد تجريبي مجاني بقيمة $0.50 هناك بنقرة واحدة، بدون بطاقة.

pip install openai
export API_KEY="your-key-here"

الآن أصغر سكريبت يعمل. يأخذ العميل عنوان URL الأساسي والمفتاح؛ يستخدم الطلب معرف النموذج uncensored.

import os
from openai import OpenAI

client = OpenAI(
    base_url="https://api.aiapisource.com/v1",
    api_key=os.environ["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 mystery novel."},
    ],
    temperature=0.8,
)

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

هذا هو التكامل بأكمله. تنفذ الخدمة POST /v1/chat/completions و GET /v1/models، مما يغطي ما تستخدمه معظم السكريبتات. إنه نموذج نصي فقط، لذا فإن نقاط النهاية الخاصة بالصور والصوت والتضمينات غير متاحة.

ما هو هذا، وما ليس هذا

وحدة SDK من صنع OpenAI، لكن نقطة النهاية هنا ليست تابعة لـ OpenAI. إنه نموذج مفتوح الأوزان مستضاف، ويشغّله مزوّد مستقل ومضبط للإجابة بدون رفض المحتوى للاستخدام القانوني للبالغين. لا يوجد توجيه إلى GPT أو أي نموذج من مزود آخر. هذا هو السبب في أنك تغير عنوان URL الأساسي: أنت تتحدث إلى خادم مختلف يقبل نفس تنسيق الطلب.

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

بث الرد

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

stream = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Write a four-line poem about a night train."}],
    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="", flush=True)
    if chunk.usage:
        print("\ntokens:", chunk.usage.prompt_tokens, chunk.usage.completion_tokens)

الفحص على chunk.choices مهم: قد تحمل آخر قطعة (chunk) بيانات الاستخدام دون أي choices. أيضًا، يحتفظ الطلب المتدفق بإحدى فتحاتك المتزامنة حتى ينتهي البث، لذا اقرأه دائمًا حتى النهاية أو أغلقه.

وضع JSON

عندما يحتاج كودك إلى تحليل الإجابة، فعّل وضع JSON وصِف المفاتيح في الموجّه:

import json

resp = client.chat.completions.create(
    model="uncensored",
    response_format={"type": "json_object"},
    messages=[
        {"role": "user", "content": "Return JSON with keys name (string) and traits (list of 3 strings) for a fictional ship captain."}
    ],
)
character = json.loads(resp.choices[0].message.content)
print(character["name"], character["traits"])

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

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

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

import json

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 20-sided die for my character."}]
first = client.chat.completions.create(model="uncensored", messages=messages, tools=tools)
msg = first.choices[0].message

if msg.tool_calls:
    messages.append(msg)
    for call in msg.tool_calls:
        args = json.loads(call.function.arguments)
        result = {"value": 14, "sides": args["sides"]}  # replace with real logic
        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)
else:
    print(msg.content)

يمكنك تمرير tool_choice لفرض دالة. تأتي الحجج كسلسلة JSON، لذا قم بتشغيلها دائمًا عبر json.loads وتحقق منها قبل الاستخدام.

الأخطاء، إعادة المحاولة، والعمليات غير المتزامنة

تعيد وحدة SDK محاولة بعض الأخطاء بمفردها، ويمكنك تعيين العدد مع max_retries. بالنسبة لحدّ المعدل، التقط الاستثناء وانتظر. تُرجع واجهة API HTTP 429 مع الرمز rate_limited عندما تتجاوز الحد الأقصى في الدقيقة، مع concurrency عندما تعمل العديد من الطلبات في وقت واحد، ومع رأس Retry-After: 5 عند الحمل الزائد المؤقت.

import time
from openai import RateLimitError

def ask(prompt, tries=4):
    for attempt 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 * (attempt + 1))
    raise RuntimeError("Still rate limited after retries")

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

import asyncio, os
from openai import AsyncOpenAI

aclient = AsyncOpenAI(base_url="https://api.aiapisource.com/v1", api_key=os.environ["API_KEY"])
sem = asyncio.Semaphore(6)

async def one(prompt):
    async with sem:
        r = await aclient.chat.completions.create(
            model="uncensored",
            messages=[{"role": "user", "content": prompt}],
        )
        return r.choices[0].message.content

async def main():
    prompts = [f"Write a tagline for product number {i}." for i in range(20)]
    results = await asyncio.gather(*(one(p) for p in prompts))
    print(len(results), "done")

asyncio.run(main())

استخدام 6 من أصل 8 فتحات يترك مساحة لحركة المرور الأخرى على نفس المفتاح.

حافظ على استمرار المحادثة

الواجهة البرمجية (API) عديمة الحالة. لا تحتفظ بأي بيانات بين الاستدعاءات، لذا فإن الدردشة هي مجرد قائمة الرسائل التي ترسلها في كل مرة. أضف الرد إلى القائمة وأرسل القائمة بأكملها مرة أخرى:

history = [{"role": "system", "content": "You are a patient writing coach."}]

def chat(user_text):
    history.append({"role": "user", "content": user_text})
    r = client.chat.completions.create(model="uncensored", messages=history)
    reply = r.choices[0].message.content
    history.append({"role": "assistant", "content": reply})
    return reply

print(chat("Give me a prompt for a short story."))
print(chat("Make it darker and set it in a harbour town."))

يُرسِل كل استدعاء رموزًا أكثر من السابق، وتُحسَب تكلفة رموز الإدخال في كل استدعاء. عندما يطول السجل، احذف أقدم الأدوار أو استبدلها بملخص قصير. نافذة السياق هي 100,000 رمز للموجّه والإكمال، وهو عدد كبير، لكن طول السجل التاريخي يجعل كل طلب أكثر تكلفة وأبطأ في البدء.

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

قدّر التكلفة قبل تشغيل كبير

الفوترة تكون لكل رمز من رصيد مسبق الدفع: $0.15 لكل مليون رمز مدخل و$0.50 لكل مليون رمز مخرج. الطلبات الفاشلة أو المرفوضة لا تُحسب لها رسوم، ولا ينتهي الرصيد. خذ دفعة من 10,000 طلب مع 1,500 رمز مدخل و400 رمز مخرج لكل طلب. المدخلات هي 15,000,000 رمز، وهو ما يعادل 15 × $0.15 = $2.25. المخرجات هي 4,000,000 رمز، وهو ما يعادل 4 × $0.50 = $2.00. تكلفة الدفعة هي $4.25.

تتضمن رؤوس الاستجابة X-Balance-USD، مما يتيح لك قراءة رصيدك المتبقي في الكود عبر client.chat.completions.with_raw_response.create(...). الشحنات هي أي مبلغ صحيح يتراوح بين $20 و$500، مع إضافة +5% من $50، و+10% من $100، و+15% من $200. تذكر صفحة التسعير خيارات الدفع، وتذكر صفحة البدء السريع كل معلمة مدعومة، بما في ذلك stop، seed والعقوبات.

أسئلة وأجوبة

هل يمكنني استخدام حزمة Python الرسمية من OpenAI مع هذه الواجهة؟

نعم. قم بتثبيت openai، واضبط base_url لتكون نقطة النهاية للخدمة وapi_key ليكون مفتاحك، ثم قم باستدعاء chat.completions.create مع النموذج uncensored.

هل أحتاج إلى مكتبة مختلفة للبث المتدفق أو الأدوات؟

لا. يعمل البث المتدفق، ووضع JSON، واستدعاء الدوال عبر نفس طرق الـ SDK، مع المعاملات المعتادة.

هل هذا نموذج OpenAI؟

لا. إنه نموذج مفتوح الأوزان تشغله جهة مستقلة. صيغة الطلب هي نفسها، وهذا هو سبب عمل الـ SDK.

هل تُدرّب الموجّهات النموذج؟

لا. لا تُستخدم الموجّهات المرسلة عبر واجهة الـ API للتدريب.

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

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

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