البدء السريع لمستخدمي Kimicode

المتطلبات المسبقة

قبل كتابة الكود، أنشئ حسابًا على kimicode.cc باستخدام Google أو البريد الإلكتروني. ستتلقى مفتاح API واحدًا على الفور. لا يتطلب التحقق من الهاتف ولا بطاقة ائتمان. يبدأ حسابك برصيد تجريجي مجاني بقيمة $0.50 صالح لمدة سبعة أيام. إذا كنت بحاجة إلى سعة أكبر، قم بشحن الرصيد عبر العملات المشفرة (USDT على شبكة TRC20 أو USDC على Base) بحد أدنى $10. لا ينتهي الرصيد أبدًا، ولا تستهلك الأخطاء أو الرفضات الرموز.

تأكد من أن بيئة التطوير الخاصة بك تحتوي على Node.js (v18+) أو Python 3.8+. تتبع هذه الواجهة بصرامة مواصفات العميل openai، مما يعني أنه يمكنك استبدال نقطة النهاية الخاصة بنا دون تغيير منطق المكتبة. نقدم نموذجاً واحداً بدون رقابة تحت المعرف uncensored.

تثبيت SDK

قم بتثبيت SDK الرسمي لـ OpenAI للغة المفضلة لديك. يضمن ذلك التوافق مع ميزات البث، واستدعاء الدوال، ووضع JSON لدينا.

لـ Python، استخدم pip لتثبيت المكتبة القياسية:

• pip install openai

لـ Node.js، قم بتثبيت حزمة npm:

• npm install openai

تتعامل هذه المكتبات مع تنسيق HTTP تلقائياً. لا تحتاج إلى عميل خاص بالبائع. تقبل واجهة kimicode المعلمات القياسية مثل temperature، وtop_p، وmax_tokens.

تهيئة العميل

قم بتكوين كائن العميل الخاص بك مع عنوان URL الأساسي لـ kimicode ومفتاح API الخاص بك. عنوان URL الأساسي هو https://api.kimicode.cc/v1. اضبط api_key على القيمة التي تلقيتها عند التسجيل. يحل هذا التكوين محل نقطة النهاية الافتراضية api.openai.com.

• عنوان URL الأساسي: https://api.kimicode.cc/v1
• النموذج: uncensored
• المصادقة: رمز Bearer عبر api_key

لا تخلط بين هذا المفتاح مع البائعين الآخرين. يعمل حصرياً مع نقطة النهاية kimicode. سيتحقق العميل من صحة المفتاح في الطلب الأول. إذا كان المفتاح غير صالح، ستتلقى خطأ 401 على الفور.

إجراء طلب

أرسل طلب إكمال محادثة قياسي. يجب أن يكون معرف النموذج هو uncensored. يمكنك ضبط max_tokens حتى 32,000. إذا تم حذفه، فإن القيمة الافتراضية هي 2,048. نافذة السياق هي 100,000 رمز إجمالاً للموجّه والإكمال معاً.

• الإدخال: رسائل نصية في مصفوفة messages.
• الإخراج: استجابة نصية في choices[0].message.content.

تدعم نقطة النهاية هذه وضع JSON عبر response_format: {"type": "json_object"}. لا تدعم التضمينات أو الصور أو الصوت. ركز على توليد نصوص عالية الجودة دون رفض المحتوى للمواضيع القانونية للبالغين.

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

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

• علم البث: اضبطه على true في جسم الطلب.
• نوع الحدث: chat.completion.chunk
• البيانات: يحتوي على delta.content لأجزاء النص.

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

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

راقب حدود الاستخدام الخاصة بك: 300 طلب في الدقيقة لكل مفتاح، و8 طلبات متزامنة، وجسم طلب بحجم 8 ميجابايت. إذا تجاوزت حدّ المعدل، تتلقى خطأ 429. إذا استنفدت رصيدك المسبق للدفع، تتلقى خطأ 402؛ قم بالشحن عبر العملات المشفرة للمتابعة. يشير خطأ 401 إلى مفتاح API غير صالح أو مفقود. لاحظ أن الطلبات الفاشلة والرفض لا تستهلك الرموز. يحجب الحد القاطع للمحتوى المحتوى الجنسي الذي يتضمن قاصرين. جميع المحتويات القانونية الأخرى للبالغين مسموح بها.

استدعاء الدوال

عرّف الأدوات في المعلمة tools. يعيد النموذج استدعاءات الأدوات في الاستجابة. استخدم tool_choice لفرض سلوك معين. تعمل هذه الميزة بنفس الطريقة القياسية لـ OpenAI. قم بتحليل استدعاءات الأدوات في الكود الخاص بك ونفذها. أرسل النتائج مرة أخرى في الرسائل اللاحقة. تتعامل واجهة kimicode مع تعريفات الأدوات بكفاءة. تأكد من صحة مخطط JSON الخاص بك. لا يتطلب استدعاء الدوال رصيداً إضافياً بجانب استخدام الرموز. إنه مثالي لبناء الوكلاء أو سير عمل استخراج البيانات المهيكلة.

cURL

Copycurl https://api.kimicode.cc/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."}]
  }'

Python

Copyfrom openai import OpenAI

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

Copyimport OpenAI from "openai";

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

البث

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)