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