Mini cpm API documentation

المصادقة وURL الأساسي

ابدأ كل طلب بمفتاح واجهة برمجة التطبيقات (API) الصحيح وعنوان URL الأساسي. نستخدم رؤوس OpenAI القياسية للتوافق. يمنحك مفتاحك الوصول إلى النموذج غير المقيد فوراً. عنوان URL الأساسي هو HTTPS://api.cpmmini.com/v1. استخدم الرأس Authorization: Bearer . احفظ مفتاحك بأمان. يحدد حساب رصيدك المدفوع مسبقاً. لا توجد رسوم اشتراك هنا. ادفع فقط مقابل الرمز المستخدم.

الطلب الأول

أرسل أول رسالة إلى نقطة نهاية إكمال الدردشة. يؤكد هذا أن مفتاحك يعمل وأن الخصم من الرصيد يتم بشكل صحيح. يستجيب النموذج غير المقيد (uncensored) دون الرفض المعتاد. استخدم curl للاختبار السريع. استبدل YOUR_API_KEY بمفتاحك الفعلي من لوحة التحكم. تتحقق هذه الخطوة من الاتصال وزمن الاستجابة. تشير الأخطاء مثل 401 إلى مفتاح غير صالح. تحقق من لوحة حسابك إذا فشل الأمر. يعيد الاستجابة النص المولد.

تكامل واجهة برمجة تطبيقات Python

استخدم مكتبة بايثون الرسمية الخاصة بـ OpenAI للوصول البرمجي. قم بتعيين عنوان URL الأساسي إلى نقطة النهاية الخاصة بنا. يضمن ذلك توجيه جميع الطلبات إلى نموذجنا غير المقيد. قم بتثبيت المكتبة عبر pip. مرر مفتاح واجهة برمجة التطبيقات الخاص بك في تهيئة العميل. اطلب النموذج uncensored. تتولى مكتبة SDK عمليات إعادة المحاولة وتحليل JSON. يبسط هذا النهج التكامل في الروبوتات الحالية الخاصة بك. يعمل أيضًا مع حلقات غير المتزامن. تحقق من رصيدك بعد المكالمة.

إعداد Node SDK

قم بالتكامل مع Node.js باستخدام حزمة npm. قم بتكوين عنوان URL الأساسي للإشارة إلى واجهة برمجة التطبيقات الخاصة بنا. يحافظ ذلك على التوافق مع معايير OpenAI. قم بتثبيت التبعية في مشروعك. قم بتهيئة العميل باستخدام مفتاحك. قم باستدعاء طريقة إكمال الدردشة. يحتوي كائن الاستجابة على النص المولد. تعامل مع الأخطاء بسلاسة في تطبيقك. يدعم هذا الإعداد كلًا من وحدات CommonJS و ES. إنه مثالي لروبوتات الدردشة على جانب الخادم.

استجابات البث

قم بتدفق الرموز لتجارب مستخدم في الوقت الفعلي. فعّل التدفق في معاملات الطلب. ترسل واجهة برمجة التطبيقات كتلًا أثناء توليدها. يقلل هذا من زمن الاستجابة المُدرَك للمستخدمين. استخدم نقطة نهاية SSE للبيانات المستمرة. قم بتحليل كل كتلة لبناء الرسالة النهائية. تعمل هذه الميزة مع كل من مكتبات Python و Node. إنها ضرورية لواجهات الدردشة. راقب استخدام الرموز في الكتلة الأخيرة. يتم خصم رصيدك بناءً على إجمالي الرموز المرسلة.

حدود، أخطاء، والسياق

راقب حدود معدل الطلبات وحالة الرصيد. تحصل على 300 طلب في الدقيقة. يُسمح بثمانية طلبات متزامنة فقط لكل مفتاح. يعني خطأ 429 أنك وصلت إلى الحد. يشير خطأ 402 إلى عدم كفاية الرصيد. اشحن بالعملات المشفرة للمتابعة. تدعم مساحة السياق 100,000 رمز. هذا يسمح بمحادثات طويلة دون فقدان السجل. لا تكلف الأخطاء والرفضات رصيداً. لا ينتهي صلاحية رصيدك المسبق. أدر مفاتيحك في لوحة التحكم.

cURL

Copycurl https://api.cpmmini.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Send test message"}]
  }'

Python

Copyfrom openai import OpenAI

client = OpenAI(base_url="https://api.cpmmini.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

Copyimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.cpmmini.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);

التدفق

Copystream = 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)