البدء السريع: دمج واجهة برمجة التطبيقات الرخيصة للذكاء الاصطناعي

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

To use our cheap ai api, you need an API key from your dashboard. All requests target the base URL https://api.cheapaiapis.com/v1. This ensures compatibility with existing OpenAI SDKs and clients.

أدرج مفتاحك في رأس Authorization كرمز Bearer. إذا كان المفتاح غير صالح، ستتلقى خطأ 401. إذا استُنفد رصيدك المسبق للدفع، تحصل على خطأ 402. سجّل في Get API key للحصول على الرمز الخاص بك على الفور.

معرف النموذج لـ LLM بدون رقابة هو ببساطة "uncensored". يتعامل هذا النموذج الوحيد مع جميع مهام توليد النصوص بدون عبء التوجيه.

Copycurl https://api.cheapaiapis.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."}]
  }'

إكمال المحادثات القياسي

تقبل نقطة النهاية chat completions api طلبات POST مع مصفوفة رسائل. تتطلب كل رسالة دوراً (system، user، أو assistant) ومحتوى. يسمح هذا الهيكل بالمحادثات متعددة الأدوار أو الموجّهات أحادية الطلقة.

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

استخدم SDK الخاص بـ Python للدمج بسرعة. يتعامل العميل تلقائياً مع التسلسل وطلبات HTTP.

Copyfrom openai import OpenAI

client = OpenAI(base_url="https://api.cheapaiapis.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)

استجابات البث المتدفق (SSE)

لتطبيقات التغذية الراجعة في الوقت الفعلي، فعّل البث المتدفق عن طريق تعيين stream: true. تعيد الـ API أحداثاً مرسلة من الخادم (SSE) تحتوي على أجزاء رموز جزئية.

يقلل هذا النهج من زمن الاستجابة المدرك للمستخدمين النهائيين. تعالج كل جزء عند وصوله، وتجمع الاستجابة النهائية. يعمل البث المتدفق مع جميع العملاء المتوافقين مع OpenAI المهيئين لـ SSE.

انتبه لحدّ المعدل البالغ 300 طلب في الدقيقة لكل مفتاح. لا يتجاوز البث المتدفق حدّ المعدل؛ بل يغير فقط طريقة تسليم البيانات.

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)

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

تسمح لك تنفيذية function calling api لدينا بتعريف الأدوات في الطلب. يعيد النموذج JSON هيكلي مطابق لمخططك، مما يتيح إجراءات برمجية.

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

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

عرض النماذج والرموز

استخدم GET /v1/models لاسترداد النماذج المتاحة. سترى نموذج "uncensored" مدرجاً مع قدراته المحددة.

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

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

الحدود والأخطاء والنافذة السياقية

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

تشمل الأخطاء الشائعة 401 (مفتاح غير صالح)، 402 (أموال غير كافية)، و429 (حد المعدل). تعامل مع هذه الأخطاء بسلاسة في كود العميل الخاص بك.

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

Node.js

Copyimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.cheapaiapis.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);