kimiapikey.comالمستندات
واجهة برمجة التطبيقات (API) الخاصة بـ Kimi: أول طلب في خمس دقائق
احصل على أول استجابة في أقل من خمس دقائق باستخدام واجهة متوافقة مع OpenAI. يغطي هذا الدليل الإعداد، والمصادقة، والاستخدام الأساسي للنموذج بدون رقابة.
المتطلبات المسبقة
للبدء، تحتاج إلى مفتاح API من kimiapikey.com. سجّل باستخدام البريد الإلكتروني وكلمة المرور فقط؛ لا يلزم بطاقة ائتمان للتجربة. تحتاج أيضاً إلى بيئة لغة مدعومة مع تثبيت SDK رسمي أو متوافق. يتبع الـ API الخاص بنا تنسيق chat-completions من OpenAI، لذا فإن الكود الموجود لـ GPT-3.5/4 غالباً ما يعمل بتغييرات قليلة. تأكد من أن إصدار SDK الخاص بك حديث بما يكفي لدعم معلمة base_url.
عنوان URL الأساسي والمصادقة
توجد واجهة برمجة التطبيقات (API) الخاصة بنا عند https://api.kimiapikey.com/v1. تتم المصادقة عبر رأس Authorization القياسي. مرر مفتاحك كرمز Bearer. هذا يعمل مع أي عميل يقبل نقاط النهاية المتوافقة مع OpenAI. إذا كنت تستخدم وسيطًا أو عميلًا مخصصًا، فتأكد من أنه يمرر رأس Authorization بشكل صحيح. معرف النموذج الذي ستطلبه هو uncensored.
الطلب الأول
أرسل إكمال دردشة بسيط للتحقق من إعدادك. استخدم أمر curl أدناه، واستبدل YOUR_API_KEY بمفتاحك الفعلي. يرسل هذا الطلب موجّهًا قصيرًا إلى نموذج uncensored. إذا نجح، ستتلقى استجابة JSON تحتوي على رد النموذج. تحقق من مصفوفة choices للحصول على النص المولد. إذا حصلت على خطأ 401، فإن مفتاحك غير صالح أو منتهي الصلاحية.
واجهة برمجة التطبيقات (SDK) لـ Python
استخدم مكتبة Python الرسمية لـ OpenAI لأسهل تكامل. اضبط base_url على نقطة النهاية الخاصة بنا وقم بتوفير مفتاحك. يوضح هذا المثال استدعاء توليد نص أساسي. يمكنك تعديل معلمة model إذا لزم الأمر، على الرغم من أن uncensored هو الافتراضي. يحافظ هذا النهج على قابلية نقل الشفرة عبر خدمات OpenAI المتوافقة.
واجهة برمجة التطبيقات (SDK) لـ Node.js
لمشاريع JavaScript/TypeScript، استخدم حزمة npm openai. قم بتكوين العميل باستخدام عنوان URL الأساسي الخاص بنا ومفتاح API الخاص بك. يتيح لك هذا إجراء الطلبات مباشرة من بيئة Node.js. يعكس التركيب واجهة برمجة التطبيقات (SDK) لـ Python، مما يضمن الاتساق إذا قمت بتغيير اللغات. تذكر معالجة الاستجابات غير المتزامنة بشكل صحيح باستخدام await.
استجابات البث المتدفق
للإخراج في الوقت الفعلي، فعّل البث المتدفق في واجهة برمجة التطبيقات (SDK) الخاصة بك. يرسل هذا أجزاء من النص أثناء توليدها، مما يقلل من زمن الاستجابة المتصور. استخدم علامة stream في طلبك. ستؤدي واجهة برمجة التطبيقات (SDK) إلى إرجاع استجابات جزئية، مما يسمح لك بتحديث واجهة المستخدم تدريجيًا. هذا مثالي لواجهات الدردشة أو توليد المحتوى طويل المدى حيث يكون التغذية الراجعة الفورية ذات قيمة.
الحدود والأخطاء
يتم تحديد كل مفتاح بحد 300 طلب في الدقيقة. إذا تجاوزت هذا الحد، ستتلقى خطأ 429. يجب ألا يتجاوز جسم طلبك 8 MB. تنطبق نافذة سياق بـ 100,000 رمز على مجموع الموجّه والإكمال. تشمل الأخطاء الشائعة 401 (مفتاح غير صالح) و402 (رصيد غير كافٍ). قم بشحن الرصيد عبر لوحة التحكم لمواصلة استخدام الـ API. لا تنتهي صلاحية الرصيد أبداً، ولا توجد رسوم شهرية.
cURL
curl https://api.kimiapikey.com/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.kimiapikey.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)Node.js
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.kimiapikey.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 = 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) استدعاء الدوال؟
نعم، تدعم نقطة النهاية استدعاء الأداة/الدالة بتنسيق OpenAI القياسي. يمكنك تعريف الأدوات في طلبك وسيعيد النموذج حججًا منظمة.
ماذا يحدث إذا تجاوزت حدّ المعدل؟
ستتلقى خطأ 429 Too Many Requests. انتظر قليلاً وأعد المحاولة، أو قم بترقية طبقة رصيدك المسبق الدفع للحفاظ على معدل أعلى.
هل يتم تدريب النموذج على بياناتي؟
لا. لا تُستخدم الموجّهات المرسلة إلى واجهة برمجة التطبيقات (API) للتدريب. تبقى بياناتك خاصة ولا تُستخدم لتحسين النموذج الأساسي.
مفتاحك على بُعد نموذج واحد
أنشئ حسابًا، انسخ المفتاح، غيّر عنوان URL الأساسي. هذا هو الإعداد بأكمله.
المواصفات التقنية
كل الحدود والميزات الفعلية للـ API في مكان واحد — راجعها قبل شحن الرصيد.
| البند | القيمة |
|---|---|
| صيغة API | متوافق مع OpenAI: يعمل أي SDK من OpenAI بتغيير base URL والمفتاح فقط |
| معرّف النموذج | uncensored |
| المصادقة | Authorization: Bearer YOUR_KEY |
| نقاط النهاية | POST /v1/chat/completions · GET /v1/models |
| Base URL | https://api.kimiapikey.com/v1 |
| أقصى مخرجات | حتى ما تبقى من نافذة 100,000 رمزًا؛ max_tokens اختياري (بلا حد منفصل) |
| المعاملات | temperature, top_p, stop, seed, presence_penalty, frequency_penalty |
| استدعاء الدوال | نعم — tools و tool_choice؛ الرد يتضمن tool_calls حتى أثناء البث؛ تُرسل النتائج كرسالة role: tool |
| البث المتدفق | نعم — server-sent events؛ آخر جزء يتضمن استهلاك الرموز |
| نافذة السياق | 100,000 رمز (المدخلات والمخرجات معاً) |
| وضع JSON | response_format: {"type": "json_object"} |
| الطلبات المتزامنة | حتى 8 في الوقت نفسه لكل مفتاح |
| حدّ المعدل | 300 طلب في الدقيقة لكل مفتاح |
| ترويسات الرد | X-Request-Id, X-Balance-USD, X-RateLimit-Limit-Requests, X-RateLimit-Limit-Concurrency |
| حجم الطلب | حتى 8 MB |
| السعر | $0.15 لكل مليون رمز مدخلات · $0.50 لكل مليون رمز مخرجات |
| الفوترة | رصيد مسبق الدفع حسب الاستهلاك الفعلي؛ الأخطاء والرفض مجانية |
| مكافأة | +5% من $50، +10% من $100، +15% من $200 |
| الصلاحية | الرصيد المدفوع لا تنتهي صلاحيته، بدون اشتراك |
| شحن الرصيد | USDT (TRC20) أو USDC (Base)، أي مبلغ صحيح من $20 إلى $500 |
| رصيد تجريبي مجاني | $0.50 لمدة 7 أيام، بدون بطاقة · مفتاح تجريبي: طلبان متوازيان، 60 طلبًا في الدقيقة؛ الحدود الكاملة (8 و300) بعد أول شحن |
| المفاتيح | مفتاح نشط واحد لكل حساب؛ المفتاح الجديد يحل محل القديم |
| تسجيل الدخول | 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 | النموذج مشغول — أعد المحاولة بعد ثوانٍ |