البدء السريع لمستخدمي Kimi
أضف عنوان URL الأساسي الجديد ومفتاح API لتوجيه استدعاءات SDK الخاصة بـ OpenAI الحالية إلى نموذج ذكاء اصطناعي بدون رقابة. يوضح هذا الدليل الأسطر الثلاثة الدقيقة اللازمة لبدء الدردشة، والبث، واستخدام الأدوات مع نقطة النهاية المتوافقة لدينا.
المتطلبات المسبقة: مفتاح API
قبل إرسال الطلبات، تحتاج إلى مفتاح API. سجّل في صفحة الحصول على مفتاح API باستخدام المتابعة عبر Google أو البريد الإلكتروني وكلمة المرور. يظهر مفتاحك على الفور. تحصل الحسابات الجديدة على $0.50 كرصيد تجريبي صالح لمدة 7 أيام؛ لا حاجة لبطاقة ائتمان. للاستخدام المدفوع، قم بشحن الرصيد بـ USDT (TRC20) أو USDC (Base). تتراوح الشحنات من $10 إلى $500. تحصل على مكافأة بنسبة +5% للشحنات من $50 أو أكثر، ومكافأة بنسبة +10% لمبلغ $100 أو أكثر. الرصيد لا ينتهي ويتم تحصيله فقط مقابل استخدام الرموز الفعلية. الأخطاء والرفضات مجانية. يمكنك الاحتفاظ بمفتاح نشط واحد لكل حساب؛ استبدال المفتاح القديم عند إنشاء مفتاح جديد. استخدم هذا المفتاح في رأسAuthorization لجميع الطلبات.
إكمال الدردشة الأساسي
تقبل نقطة النهايةkimi api طلبات إكمال المحادثة القياسية من OpenAI. اضبط عنوان URL الأساسي لعميلك على https://api.kimiapi.cc/v1 وقم بتوفير مفتاحك. نقدم نموذجًا واحدًا مخصصًا وغير خاضع للرقابة يُحدد بمعرف uncensored. هذا النموذج مفتوح الأوزان، ويعمل على خوادمنا، ولا يرفض المواضيع القانونية للبالغين أو الخيالية أو المثيرة للجدل. إنه ليس GPT أو Claude أو Gemini أو أي نموذج من مزود آخر. يمكنك إرسال الموجّهات واستقبال استجابات نصية. يدعم النموذج نافذة سياق بحجم 100,000 رمز (الموجّه + الإكمال). الحد الأقصى للإخراج لكل طلب هو 32,000 رمز، أو 2,048 إذا لم تضبط max_tokens. لا يتم توليد التضميمات أو الصور أو الصوت.
استجابات البث المتدفق
استخدم أحداث الإرسال من الخادم (SSE) للبث المتدفق. تبث الواجهة الرموز بمجرد توليدها. يتم تضمين معلومات استخدام الرموز في الشريحة الأخيرة من البث. يتيح لك ذلك مراقبة التكاليف في الوقت الفعلي دون انتظار الاستجابة الكاملة. يدعم البث المتدفق جميع أطر عمل OpenAI المتوافقة القياسية. اضبطstream=true في طلبك. سيتلقى العميل سلسلة من كائنات الفروق التي تحتوي على النص. يمكنك دمج هذه الفروق لإعادة بناء الاستجابة الكاملة. هذا مثالي لواجهات الدردشة حيث يتوقع المستخدمون ملاحظات فورية. يضمن kimi api زمن استجابة متوقعًا من خلال تجنب عبء الوكيل.
استدعاء الدوال (الأدوات)
تدعم الواجهة استدعاء الدوال، المعروف أيضًا بالأدوات. يمكنك تعريف الأدوات في طلبك وسيعيد النموذج حركات هيكلية عند الاقتضاء. استخدم المعلمةtools لتمرير قائمة تعريفات الأدوات. يمكنك أيضًا استخدام tool_choice لفرض أو اختيار الأدوات تلقائيًا. يعيد النموذج استجابة مع استدعاءات الأدوات، والتي يمكنك إعادة تمريرها إلى الواجهة لمواصلة المحادثة. يتيح ذلك بناء الوكلاء أو سير العمل الآلي. تتبع تعريفات الأدوات التنسيق القياسي لـ OpenAI. يتعامل النموذج غير الخاضع للرقابة مع تعريفات الأدوات بدقة دون رفض استخدامها لحالات الاستخدام الصالحة. وضع JSON متاح أيضًا لتنسيق الإخراج الأكثر صرامة.
وضع JSON
لتطبيقات الإخراج الصارم، استخدم وضع JSON. اضبطresponse_format على {"type": "json_object"}. سيحاول النموذج إرجاع كائن JSON صالح. هذا مفيد لتحليل البيانات، أو إنشاء ملفات التكوين، أو تغذية البيانات المهيكلة إلى أنظمة أخرى. يعمل وضع JSON جنبًا إلى جنب مع استدعاء الدوال. يمكنك أيضًا ضبط معلمات مثل temperature، top_p، stop، seed، presence_penalty، وfrequency_penalty للتحكم في الإبداع والحتمية. هذه المعلمات قياسية لعملاء OpenAI المتوافقين. اضبطها لتحقيق التوازن بين الاتساق والإبداع بناءً على حالة الاستخدام الخاصة بك.
الحدود والأخطاء والسياق
يتم تقييد كل مفتاح API بـ 300 طلب في الدقيقة و8 طلبات متزامنة. يجب ألا يتجاوز جسم الطلب 8 ميجابايت. إذا كان المفتاح غير صالح، تتلقى خطأ 401. إذا لم يكن لديك رصيد، تتلقى خطأ 402. إذا تجاوزت حدّ المعدل، تتلقى خطأ 429. الأخطاء والرفضات مجانية، لذا لن يتم احتساب تكاليف الطلبات الفاشلة. نافذة السياق هي 100,000 رمز إجمالي. ينطبق حد محتوى صارم: يتم رفض الطلبات التي تتضمن محتوى جنسي مع القاصرين دائمًا. الواجهة للنصوص فقط. لا تتوفر التضميمات أو الصور أو ضبط الدقة. بالنسبة لنماذج المزودين الآخرين، تحقق من وثائقهم للحصول على الأسعار الحالية والحدود. هذه الخدمة بديل مستقل، وغير تابعة لهم.
cURL
curl https://api.kimiapi.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
from openai import OpenAI
client = OpenAI(base_url="https://api.kimiapi.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
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.kimiapi.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);البث المتدفق
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)المواصفات التقنية
كل الحدود والميزات الفعلية للـ API في مكان واحد — راجعها قبل شحن الرصيد.
| البند | القيمة |
|---|---|
| صيغة API | متوافق مع OpenAI: يعمل أي SDK من OpenAI بتغيير base URL والمفتاح فقط |
| Base URL | https://api.kimiapi.cc/v1 |
| معرّف النموذج | uncensored |
| المصادقة | Authorization: Bearer YOUR_KEY |
| نقاط النهاية | POST /v1/chat/completions · GET /v1/models |
| وضع JSON | response_format: {"type": "json_object"} |
| المعاملات | temperature, top_p, stop, seed, presence_penalty, frequency_penalty |
| نافذة السياق | 100,000 رمز (المدخلات والمخرجات معاً) |
| استدعاء الدوال | نعم — tools و tool_choice؛ الرد يتضمن tool_calls حتى أثناء البث؛ تُرسل النتائج كرسالة role: tool |
| البث المتدفق | نعم — server-sent events؛ آخر جزء يتضمن استهلاك الرموز |
| أقصى مخرجات | حتى ما تبقى من نافذة 100,000 رمزًا؛ max_tokens اختياري (بلا حد منفصل) |
| حجم الطلب | حتى 8 MB |
| حدّ المعدل | 300 طلب في الدقيقة لكل مفتاح |
| ترويسات الرد | X-Request-Id, X-Balance-USD, X-RateLimit-Limit-Requests, X-RateLimit-Limit-Concurrency |
| الطلبات المتزامنة | حتى 8 في الوقت نفسه لكل مفتاح |
| رصيد تجريبي مجاني | $0.50 لمدة 7 أيام، بدون بطاقة · مفتاح تجريبي: طلبان متوازيان، 60 طلبًا في الدقيقة؛ الحدود الكاملة (8 و300) بعد أول شحن |
| الصلاحية | الرصيد المدفوع لا تنتهي صلاحيته، بدون اشتراك |
| الفوترة | رصيد مسبق الدفع حسب الاستهلاك الفعلي؛ الأخطاء والرفض مجانية |
| شحن الرصيد | USDT (TRC20) أو USDC (Base)، أي مبلغ صحيح من $10 إلى $500 |
| مكافأة | +5% من $50، +10% من $100 |
| السعر | $0.25 لكل مليون رمز مدخلات · $1.00 لكل مليون رمز مخرجات |
| تسجيل الدخول | Google أو البريد الإلكتروني وكلمة المرور |
| المفاتيح | مفتاح نشط واحد لكل حساب؛ المفتاح الجديد يحل محل القديم |
| المحتوى | محتوى البالغين مسموح؛ يُرفض أي محتوى جنسي يتعلق بالقاصرين |
رموز الأخطاء
تصل الأخطاء بصيغة JSON مع type ثابت؛ الطلبات الفاشلة أو المرفوضة لا تُحتسب.
| الرمز | النوع | المعنى |
|---|---|---|
400 | bad_request | JSON غير صالح أو رسائل فارغة أو معامل خاطئ أو تجاوز نافذة السياق |
401 | missing_key · invalid_key · key_revoked | لا يوجد مفتاح أو المفتاح خاطئ أو تم استبداله |
402 | no_credit | الرصيد فارغ — اشحن وتستأنف الطلبات فوراً |
403 | content_blocked | محتوى جنسي يتعلق بقاصرين — مرفوض دون احتساب |
404 | not_found | نقطة نهاية غير معروفة |
413 | request_too_large | جسم الطلب أكبر من 8 MB |
429 | rate_limited · concurrency | تجاوز 300 في الدقيقة أو 8 متزامنة — انتظر ثم أعد المحاولة |
503 | upstream_busy | النموذج مشغول — أعد المحاولة بعد ثوانٍ |
أسئلة وأجوبة
ما هي نافذة السياق وحد الإخراج؟
تبلغ نافذة السياق 100,000 رمز للموجّه والإكمال معاً. الحد الأقصى للإخراج لكل طلب هو 32,000 رمز. إذا لم تضبط <code>max_tokens</code>، يكون الحد 2,048 رمز.
كيف أشحن رصيد الرصيد؟
اشحن باستخدام العملات المشفرة فقط: USDT (TRC20) أو USDC (Base). المبالغ المقبولة هي دولارات كاملة من $10 إلى $500. تحصل على مكافأة بنسبة 5% للشحنات التي تبلغ $50 أو أكثر، ومكافأة بنسبة 10% لـ $100 أو أكثر. الرصيد لا ينتهي.
هل هذه واجهة برمجة التطبيقات الرسمية لـ Kimi؟
لا. هذه خدمة مستقلة توفر نقطة نهاية متوافقة مع OpenAI. نقدم نموذجاً واحداً بدون رقابة. لسنا تابعين لـ Moonshot AI أو أي مورد آخر. تحقق من وثائق المورد الخاصة بواجهات برمجة التطبيقات الرسمية الخاصة بهم.
مفتاحك على بُعد نموذج واحد
أنشئ حساباً، انسخ المفتاح، غيّر عنوان URL الأساسي. هذا هو الإعداد الكامل.