دمج API LLM الرخيص في 5 دقائق
شغّل API LLM الرخيص في أقل من خمس دقائق باستخدام نقطة النهاية المتوافقة مع OpenAI. أرسل نصوصًا غير خاضعة للرقابة باستخدام مكتبات SDK القياسية بدون أي إعداد.
https://api.cheapllmapis.com/v1uncensored
المتطلبات المسبقة: تثبيت SDK
قبل إرسال الطلبات، تأكد من امتلاكك مفتاح API من صفحة الحصول على مفتاح API. ندعم العملاء المتوافقين مع OpenAI القياسية، لذا من المحتمل أن تكون لديك الأدوات مثبتة بالفعل. بالنسبة لـ Python، قم بتثبيت المكتبة الرسمية. بالنسبة لـ Node.js، استخدم حزمة npm. يعمل API الخاص بنا مع أي عميل يقبل base_url و رأس Authorization. إذا كنت تنتقل من مزود آخر، فأنت بحاجة فقط لتحديث هاتين نقطتي التكوين.
الخطوة 1: ضبط متغير البيئة
يتم التعامل مع المصادقة عبر رمز Bearer. احفظ مفتاحك بأمان في متغيرات البيئة لتجنب تخزين بيانات الاعتماد في ملفات المصدر. يتم إنشاء المفتاح فورًا بعد التسجيل في لوحة التحكم الخاصة بنا. يمكنك تجديده في أي وقت لإلغاء المفتاح القديم، وهو مفيد للأمان أو عند تغيير البيئات.
قم بتسمية المتغير بـ CHEAP_LLM_API_KEY أو أي اسم يتوقعه SDK الخاص بك. عنوان URL الأساسي لدينا هو https://api.cheapllmapis.com/v1. نقطة النهاية هذه متوافقة مع مكتبات OpenAI الرسمية، مما يعني أنه يمكنك استخدام نفس بنية الكود التي تعتاد عليها.
الخطوة 2: طلب إكمال الدردشة الأساسي
أرسل طلبك الأول لتوليد النص. نقدم نموذجًا واحدًا غير خاضع للرقابة يُعرّف بـ uncensored. هذا النموذج مفتوح الأوزان ومضبوط للاستخدام القانوني للبالغين، ويوفر استجابات مباشرة دون الرفض القياسي. نقطة النهاية هي POST /v1/chat/completions. يمكنك إرسال موجّهات بسيطة أو تعليمات نظام معقدة.
curl https://api.cheapllmapis.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."}]
}'يعيد هذا الطلب كائن JSON قياسي يحتوي على النص المولد. لا يوجد توجيه للنموذج؛ أنت تتحدث مباشرة مع نموذجنا المحسن بدون رقابة. هذا يبقي زمن الوصول منخفضًا ويوضح التسعير عند $0.15 لكل مليون رمز مدخل.
الخطوة 3: تمكين استجابات البث المتدفق
للتطبيقات التي تتطلب توليد نص في الوقت الفعلي، مثل واجهات الدردشة، فعّل البث المتدفق. أرسل stream: true في جسم الطلب. سيعيد API تدفق أحداث المخدم (SSE) للاستجابات الجزئية. هذا يسمح لواجهة المستخدم الأمامية بعرض الرموز بمجرد توليدها، مما يحسن الأداء المدرك. البث المتدفق مدعوم في نفس نقطة النهاية chat/completions.
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)معالجة التدفق مباشرة في معظم مكتبات SDK الحديثة. أنت ببساطة تتكرر عبر تدفق الاستجابة. هذه الميزة ضرورية لتجربة المستخدم في تطبيقات الذكاء الاصطناعي التفاعلية. لاحظ أن البث المتدفق لا يؤثر على التسعير؛ يتم شحنك مقابل إجمالي الرموز المولدة.
الخطوة 4: استخدام استدعاء الأداة/الدالة
يدعم API الخاص بنا استدعاء الأداة، مما يسمح لـ LLM الخاص بك بإخراج بيانات هيكلية لتنفيذها بواسطة تطبيقك. عرّف دوالك في معلمة tools. سيعيد النموذج استجابات استدعاء الأداة بدلاً من النص عند الاقتضاء. ثم تقوم بتنفيذ الأداة وإرجاع النتيجة إلى المحادثة. هذا يتيح سير عمل معقد مثل استعلامات قاعدة البيانات أو عمليات البحث على الويب.
from openai import OpenAI
client = OpenAI(base_url="https://api.cheapllmapis.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)يعمل استدعاء الدالة مع النموذج القياسي uncensored. تأكد من أن تعريفات الدوال الخاصة بك تتبع مخطط OpenAI. هذه الميزة متاحة فورًا بعد التسجيل برصيدك التجريبي أو رصيدك المسبق للدفع.
الخطوة 5: التحقق من النماذج المتاحة
تحقق من اتصالك وشاهد النماذج المتاحة عن طريق إرسال طلب GET إلى /v1/models. تعيد نقطة النهاية هذه قائمة بالنماذج المتاحة بمفتاح API الخاص بك. حاليًا، سترى نموذج uncensored. هذا مفيد لتصحيح الأخطاء أو التحقق من أن عميلك يشير إلى عنوان URL الأساسي الصحيح.
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.cheapllmapis.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);تتضمن الاستجابة تفاصيل النموذج مثل المعرف ونوع الكائن. تساعد نقطة النهاية القياسية هذه في ضمان تكوين التكامل بشكل صحيح قبل إرسال حمولات كبيرة. تؤكد أنك تستخدم نموذجنا الوحيد المحسن بدون أي طبقات توجيه مخفية.
أسئلة وأجوبة
ما هي حدود المعدل والأخطاء؟
أنت محدود بـ 300 طلب في الدقيقة لكل مفتاح. يشير الخطأ 401 إلى مفتاح API غير صالح أو ملغي. يعني الخطأ 402 أن رصيدك المسبق للدفع قد استنفد. يشير الخطأ 429 إلى تجاوز حدّ المعدل. يؤدي تجديد مفتاحك إلى إلغاء القديم لكنه لا يعيد تعيين عدادات حدّ المعدل.
كيف تعمل التسعير؟
نستخدم نظام الدفع حسب الاستخدام مع رصيد مسبق الدفع وبدون رسوم شهرية. تكلف الرموز المدخلة $0.15 لكل مليون، وتكلف الرموز المخرجة $0.50 لكل مليون. تبدأ الشحنات من $20، مع مكافآت للمبالغ الأكبر. رصيد التجريبي هو $0.50 صالح لمدة 7 أيام.
ما هي نافذة السياق؟
يدعم النموذج نافذة سياق بـ 100,000 رمز، تغطي كلًا من الموجّه والإكمال. هذا يسمح بتحليل المستندات بشكل كبير أو المحادثات الطويلة. لا يوجد حد منفصل للإدخال مقابل الإخراج ضمن هذه نافذة السياق الإجمالية.
مفتاحك على بُعد نموذج واحد
أنشئ حسابًا، انسخ المفتاح، غيّر عنوان URL الأساسي. هذا هو الإعداد الكامل.
المواصفات التقنية
كل الحدود والميزات الفعلية للـ API في مكان واحد — راجعها قبل شحن الرصيد.
| البند | القيمة |
|---|---|
| صيغة API | متوافق مع OpenAI: يعمل أي SDK من OpenAI بتغيير base URL والمفتاح فقط |
| Base URL | https://api.cheapllmapis.com/v1 |
| المصادقة | Authorization: Bearer YOUR_KEY |
| معرّف النموذج | uncensored |
| نقاط النهاية | POST /v1/chat/completions · GET /v1/models |
| استدعاء الدوال | نعم — tools و tool_choice؛ الرد يتضمن tool_calls حتى أثناء البث؛ تُرسل النتائج كرسالة role: tool |
| أقصى مخرجات | حتى ما تبقى من نافذة 100,000 رمزًا؛ max_tokens اختياري (بلا حد منفصل) |
| البث المتدفق | نعم — server-sent events؛ آخر جزء يتضمن استهلاك الرموز |
| المعاملات | temperature, top_p, stop, seed, presence_penalty, frequency_penalty |
| وضع JSON | response_format: {"type": "json_object"} |
| نافذة السياق | 100,000 رمز (المدخلات والمخرجات معاً) |
| الطلبات المتزامنة | حتى 8 في الوقت نفسه لكل مفتاح |
| ترويسات الرد | X-Request-Id, X-Balance-USD, X-RateLimit-Limit-Requests, X-RateLimit-Limit-Concurrency |
| حدّ المعدل | 300 طلب في الدقيقة لكل مفتاح |
| حجم الطلب | حتى 8 MB |
| الفوترة | رصيد مسبق الدفع حسب الاستهلاك الفعلي؛ الأخطاء والرفض مجانية |
| شحن الرصيد | USDT (TRC20) أو USDC (Base)، أي مبلغ صحيح من $20 إلى $500 |
| الصلاحية | الرصيد المدفوع لا تنتهي صلاحيته، بدون اشتراك |
| رصيد تجريبي مجاني | $0.50 لمدة 7 أيام، بدون بطاقة · مفتاح تجريبي: طلبان متوازيان، 60 طلبًا في الدقيقة؛ الحدود الكاملة (8 و300) بعد أول شحن |
| مكافأة | +5% من $50، +10% من $100، +15% من $200 |
| السعر | $0.15 لكل مليون رمز مدخلات · $0.50 لكل مليون رمز مخرجات |
| المحتوى | محتوى البالغين مسموح؛ يُرفض أي محتوى جنسي يتعلق بالقاصرين |
| تسجيل الدخول | 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 | النموذج مشغول — أعد المحاولة بعد ثوانٍ |