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