دليل البدء السريع لواجهة برمجة التطبيقات (API) ia

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

استخدم مفتاح API الفريد الخاص بك مع كل طلب إلى https://api.apiia.cc/v1 عنوان URL الأساسي. تعمل نقطة نهاية هذه المتوافقة مع OpenAI مع أي SDK قياسي عن طريق تعيين عنوان URL الأساسي وتوفير مفتاحك في Authorization الرأس. يتم إنشاء المفتاح فورًا عند التسجيل عبر Google أو البريد الإلكتروني، دون الحاجة إلى رقم هاتف. احتفظ بمفتاحك بأمان، لأنه يمنحك وصولاً مباشرًا إلى رصيدك المدفوع مسبقًا. يمكنك إنشاء مفتاح جديد في أي وقت، والذي يستبدل المفتاح السابق فورًا.

إرسال أول إكمال لك

أرسل طلب POST إلى /v1/chat/completions باستخدام النموذج المحدد "uncensored". تتعامل واجهة النص الداخل/الخارج البسيطة مع مطالباتك دون رفض المحتوى للاستخدام القانوني للبالغين. يمكنك التحكم في طول الاستجابة باستخدام max_tokens معامل، الذي يفترض افتراضيًا 2,048 إذا تم تجاهله. يدعم النموذج نافذة سياق بحجم 100,000 رمز، مما يسمح بسجلات موجهة كبيرة. استخدم هذه النهاية لتوليد النصوص الموثوق وغير المفلتر.

Copycurl https://api.apiia.cc/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "What is the capital of France?"}]
  }'

تكامل واجهة برمجة تطبيقات Python

ثبّت الحزمة الرسمية لـ Python الخاصة بـ OpenAI واعدد عنوان URL الأساسي ليشير إلى خدمتنا. يتيح لك ذلك استخدام الأساليب المألوفة مثل chat.completions.create() مع نموذجنا غير الخاضع للرقابة. تتولى الحزمة الرسمية الترميز وتنسيق الطلبات تلقائيًا. يمكنك تمرير معلمات مثل temperature و top_p التحكم في الإبداع والعشوائية. يبسط هذا النهج التكامل في تطبيقات Python الحالية أو سير عمل علوم البيانات.

Copyfrom openai import OpenAI

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

استخدم حزمة Node.js SDK الخاصة بـ OpenAI عن طريق تعيين BASE_URL متغير البيئة أو تكوين مثيل العميل. هذا يتيح التكامل السلس مع مشاريع JavaScript وTypeScript. يدعم SDK جميع ميزات إكمال الدردشة القياسية، بما في ذلك استدعاء الوظائف ووضع JSON. يمكنك التبديل بسهولة بين أوضاع البث وغير البث. يجعل هذا المرونة من هذا الحل مثاليًا لبناء تطبيقات الويب أو الوظائف الخالية من الخوادم التي تتطلب توليد نص غير خاضع للرقابة.

Copyimport OpenAI from "openai";

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

استجابات البث مع SSE

فعّل البث عن طريق تعيين stream: true في طلبك. تُعيد واجهة برمجة التطبيقات أحداث الإرسال الخادم (SSE) مع كل رمز مميز بمجرد توليده. يوفر هذا ملاحظات فورية، مما يقلل من زمن الاستجابة المُدرَك للمستخدمين النهائيين. تتضمن الشريحة الأخيرة إحصائيات استخدام الرموز المميزة، مما يتيح لك تتبع التكاليف بدقة. يعد التدفق ضرورياً لواجهات الدردشة التفاعلية وتوليد المحتوى الديناميكي. يضمن تجربة مستخدم سلسة حتى مع الاستجابات الأطول.

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)

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

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