AR ▾
احصل على مفتاح API

أول طلب في خمس دقائق

أدخل مفتاح 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 URLhttps://api.kimiapi.top/v1
نقاط النهايةPOST /v1/chat/completions · GET /v1/models
المصادقةAuthorization: Bearer YOUR_KEY
معرّف النموذجuncensored
نافذة السياق100,000 رمز (المدخلات والمخرجات معاً)
وضع JSONresponse_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 ثابت؛ الطلبات الفاشلة أو المرفوضة لا تُحتسب.

الرمزالنوعالمعنى
400bad_requestJSON غير صالح أو رسائل فارغة أو معامل خاطئ أو تجاوز نافذة السياق
401missing_key · invalid_key · key_revokedلا يوجد مفتاح أو المفتاح خاطئ أو تم استبداله
402no_creditالرصيد فارغ — اشحن وتستأنف الطلبات فوراً
403content_blockedمحتوى جنسي يتعلق بقاصرين — مرفوض دون احتساب
404not_foundنقطة نهاية غير معروفة
413request_too_largeجسم الطلب أكبر من 8 MB
429rate_limited · concurrencyتجاوز 300 في الدقيقة أو 8 متزامنة — انتظر ثم أعد المحاولة
503upstream_busyالنموذج مشغول — أعد المحاولة بعد ثوانٍ

أسئلة وأجوبة

كيف تعمل الفوترة لواجهة برمجة تطبيقات Kimi؟

تدفع فقط مقابل استخدام الرموز الفعلي. تكلفة رموز الإدخال 0.25 دولار لكل مليون، وتكلفة رموز الإخراج 1.00 دولار لكل مليون. الأخطاء والرفض مجاني. الرصيد مسبق الدفع ولا ينتهي.

ما هي مدفوعات العملات المشفرة المقبولة؟

نقبل USDT (TRC20) و USDC (Base). تتراوح الشحنات من 10 إلى 500 دولار. تتم معالجة المدفوعات مباشرة بدون بطاقات أو PayPal.

ما هو حد نافذة السياق؟

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

مفتاحك على بُعد نموذج واحد

أنشئ حساباً، وانسخ المفتاح، وغير عنوان URL الأساسي. هذا هو الإعداد بالكامل.