Kimicode: أول طلب في خمس دقائق

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

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

الطلب الأول

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

نسخcurl https://api.kimicode.top/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."}]
  }'

إذا كان المفتاح غير صالح، تحصل على خطأ 401. إذا كان لديك رصيد غير كافٍ، تحصل على خطأ 402. تحقق من رصيد حسابك إذا فشلت الطلبات بشكل غير متوقع.

تكامل SDK Python

استخدم مكتبة Python الرسمية لـ OpenAI. اضبط عنوان URL الأساسي على نقطة النهاية الخاصة بنا. مرر مفتاح API الخاص بك. يتعامل العميل مع تنسيق الطلب تلقائياً. هذا يعمل لأي لغة تدعم عملاء متوافقين مع OpenAI. قم بتثبيت المكتبة عبر pip. قم بتكوين العميل بعنوان URL الأساسي والمفتاح. أرسل رسالة باستخدام نقطة نهاية إكمال الدردشة. تحتوي الاستجابة على النص المولد. يمكنك تحليل المحتوى مباشرة من كائن الاستجابة.

نسخfrom openai import OpenAI

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

يعمل SDK Node.js بنفس الطريقة. قم باستيراد العميل. قم بتكوين عنوان URL الأساسي ومفتاح API. قم باستدعاء طريقة إكمال الدردشة. مرر معرف النموذج ومصفوفة الرسائل. يتطابق هيكل الاستجابة مع تنسيق OpenAI. استخرج محتوى رسالة المساعد. يعمل هذا النهج للتوليد من جانب الخادم أو الوظائف الطرفية. لا يلزم تكوين إضافي يتجاوز تغيير عنوان URL الأساسي.

نسخimport OpenAI from "openai";

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

عالج الأخطاء بفحص رمز الحالة. حدود المعدل تعيد 429. عدم كفاية الأموال تعيد 402.

استجابات البث المتدفق

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

نسخ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)

تأكد من أن عميلك يخزن القطع بشكل صحيح. اجمع المحتوى لتشكيل الاستجابة النهائية.

حدود المعدل، الأخطاء، والنافذة

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