البدء السريع لواجهة برمجة تطبيقات Kimi غير الخاضع للرقابة

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

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

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

نفّذ إكمال محادثة أساسي للتحقق من الاتصال. أرسل طلب POST إلى /v1/chat/completions النقطة النهائية بمعرف النموذج uncensored. يستجيب هذا النموذج للمحتوى البالغ القانوني دون الرفضات القياسية. يتطلب جسم الطلب مصفوفة رسائل تحتوي على النص الأولي الخاص بك. تعيد الواجهة برمجة التطبيقات استجابات JSON القياسية من OpenAI بما في ذلك إحصائيات استخدام الرموز. تُعاد الأخطاء مثل المفاتيح غير الصالحة أو عدم كفاية الرصيد كرموز حالة HTTP قياسية. يمكنك التحقق من عنوان URL الأساسي وتكوين المفتاح قبل إرسال الطلبات المعقدة. تؤكد هذه الخطوة أن عميلك مصادق عليه بشكل صحيح.

Copycurl https://api.kimiapipricing.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "fetch my usage stats from the api endpoint"}]
  }'

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

قم بتهيئة عميل OpenAI لـ Python باستخدام عنوان URL الأساسي المخصص. مرر مفتاح API الخاص بك و base_url معامل لتجاوز نقطة النهاية الافتراضية. اضبط النموذج إلى uncensored لتوليد النص. يتيح لك هذا النهج استخدام أساليب SDK المألوفة مثل chat.completions.create(). يتعامل العميل مع التدفق وتنسيق JSON تلقائيًا. لا تحتاج إلى تعديل هيكل الرسائل مقارنة بالاستخدام القياسي لـ OpenAI. يضمن هذا التوافق ability تبديل المزود دون إعادة كتابة منطق التطبيق. قم بتكوين العميل مرة واحدة وأعد استخدامه عبر تطبيقك. يدير مكتبة البرمجيات (SDK) تجميع الاتصال ومنطق إعادة المحاولة لك.

Copyfrom openai import OpenAI

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

إعداد SDK Node.js

استيراد حزمة OpenAI وإنشاء العميل مع عنوان URL الأساسي الخاص بنا. اضبط apiKey و baseURL الخصائص لتوجيه حركة المرور بشكل صحيح. استخدم uncensored معرف النموذج في استدعاءات الإكمال الخاصة بك. يعمل هذا الإعداد مع استيرادات CommonJS و ES module على حد سواء. يمكنك إرسال نصوص استعلامية والحصول على استجابات بتنسيق JSON منظم. يتعامل مكتبة Node مع معالجة التدفق بكفاءة للمخرجات الكبيرة. قم بتكوين العميل في متغيرات البيئة الخاصة بك لإدارة المفاتيح بأمان. يتكامل هذا الأسلوب بسهولة مع Express أو النصوص البرمجية المستقلة. تحقق من الاتصال عن طريق إرسال رسالة اختبار بسيطة. تدعم المكتبة أنماط الطلبات المتزامنة وغير المتزامنة على حد سواء.

Copyimport OpenAI from "openai";

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

التعامل مع الاستجابات المتدفقة

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

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)

حدود، أخطاء، والسياق

راقب استخدامك مقابل حدود معدل الطلب والقيود السياقية الصارمة. يُسمح لك بـ 300 طلب في الدقيقة و 8 طلبات متزامنة لكل مفتاح. نافذة السياق هي 100,000 رمز مميز تشمل كل من الطلب والإكمال. الإخراج الأقصى لكل طلب هو 16,000 رمز مميز، أو 2,048 إذا لم يتم تحديدها. تُرجع الطلبات التي تتجاوز هذه الحدود رمز حالة 429. يشير خطأ 401 إلى مفتاح واجهة برمجة التطبيقات (API) غير صالح أو مفقود. يعني خطأ 402 أن رصيدك المدفوع مسبقاً قد استنفد. الأخطاء والرفضات لا تستهلك رصيدك. لا تنتهي صلاحية رصيدك المدفوع مسبقاً، لذا يمكنك إعادة الشحن لاحقاً. حد حجم جسم الطلب هو 8 ميجابايت. استخدم استدعاء الوظائف ووضع JSON ضمن هذه القيود.