دليل تكامل واجهة برمجة Ki

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

تعيش واجهة برمجة التطبيقات عند https://api.kiapi.cc/v1. تحصل على مفتاح نشط واحد لكل حساب، يظهر فورًا بعد التسجيل عبر Google أو البريد الإلكتروني. غيّر base_url في عميلك واضبط Authorization الرأس إلى Bearer YOUR_KEY. يعمل مع أي مكتلة SDK قياسية لـ OpenAI.

• URL الأساسي: https://api.kiapi.cc/v1
• رأس: Authorization: Bearer YOUR_KEY

Copycurl https://api.kiapi.cc/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "fetch latest version from github repo"}]
  }'

نقطة نهاية إكمال الدردشة

أرسل الرسائل إلى POST /v1/chat/completions. استخدم معرف النموذج uncensored للمخرجات غير المقيدة. تقبل نقطة النهاية تنسيقات الدردشة القياسية مع نافذة سياق (context window) إجمالية تبلغ 100,000 رمز مميز. تُرجع استجابات نصية دون رفض المحتوى للاستخدام القانوني للبالغين. لا تتوفر هنا عمليات التضمين (embeddings) أو توليد الصور.

Copyfrom openai import OpenAI

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

استجابات البث (SSE)

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

Copyimport OpenAI from "openai";

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

استدعاء الوظائف ووضع JSON

استخدام response_format: {"type": "json_object"} لإخراج JSON صارم. تدعم واجهة برمجة التطبيقات تعريفات الأدوات واختيارات الأدوات لاستدعاء الوظائف. يمكنك تعريف أدوات مخصصة في tools مصفوفة. سيستجيب النموذج ببيانات منظمة عند الحاجة. يعمل هذا جنبًا إلى جنب مع توليد النص القياسي.

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)

معلمات النموذج والحدود

يدعم temperature, top_p, stop, seed, ومعاملات العقوبة. الحد الأقصى للإخراج هو 16,000 رمز لكل طلب. يمكنك إرسال ما يصل إلى 300 طلب في الدقيقة. يتم تقييد التزامن بـ 8 طلبات متزامنة لكل مفتاح. يجب أن يبقى جسم الطلب أقل من 8 ميجابايت. تضمن هذه الحدود أداءً مستقرًا لمهام توليد النماذج غير الخاضعة للرقابة.

استهلاك الرموز والفوترة

ت kostet Input tokens $0.15 لكل مليون. Output tokens تكلف $0.50 لكل مليون. الأخطاء والرفض مجانيان. يُضاف الرصيد عبر العملات المشفرة فقط. الرصيد المدفوع لا ينتهي. تدفع فقط مقابل استخدام الرموز الفعلي. لا تنطبق رسوم اشتراك شهرية. يتتبع النظام الاستخدام بدقة للفوترة.