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

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

الرمزالنوعالمعنى
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النموذج مشغول — أعد المحاولة بعد ثوانٍ

أسئلة وأجوبة

ما هي نافذة السياق وحد الإخراج؟

تبلغ نافذة السياق 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 الأساسي. هذا هو الإعداد الكامل.

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