البدء السريع في واجهة برمجة التطبيقات

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

قم بتكوين العميل ليشير إلى نقطة النهاية الصحيحة وقدم مفتاحك. استخدم https://api.getcheapai.cc/v1 كعنوان URL الأساسي. مرر مفتاح واجهة برمجة التطبيقات في Authorization رأس باستخدام Bearer scheme. يعمل هذا الإعداد مع أي واجهة برمجة تطبيقات قياسية متوافقة مع OpenAI.

إرسال طلبك الأول

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

Copycurl https://api.getcheapai.cc/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Generate 500 lines of dummy JSON data"}]
  }'

تكامل مكتبة Python

قم بتهيئة العميل باستخدام المفتاح الخاص بك وعنوان URL الأساسي. قم بتعيين النموذج إلى uncensored. مرر الرسائل بالتنسيق القياسي. تتعامل مكتلة SDK مع التسلسل تلقائيًا. يقلل هذا النهج من كود الواجهة بشكل كبير.

Copyfrom openai import OpenAI

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

استخدام Node SDK

استيراد المكتبة وتكوين عنوان URL الأساسي. استدعاء chat.completions.create مع رسائلك. تعامل مع الاستجابة بشكل غير متزامن. يناسب هذا النمط بيئات JavaScript الحديثة.

Copyimport OpenAI from "openai";

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

استجابات البث

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

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)

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

تعامل مع أكواد HTTP المحددة لإدارة تدفق تطبيقك. يعني 401 أن مفتاحك غير صالح. يشير 402 إلى عدم كفاية الرصيد. يشير 429 إلى أنك وصلت إلى حد 300 طلب في الدقيقة. نافذة السياق هي 100,000 رمز إجمالي. الأخطاء لا تستهلك الرموز.

2026-050