دليل البدء السريع لواجهات برمجة تطبيقات النماذج

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

نقطة النهاية موجودة في https://api.modelapis.cc/v1. مرر مفتاحك في Authorization قيمة التوكن كـ bearer token. يرفض النظام الطلبات ذات المفاتيح غير الصالحة عبر أخطاء 401 ويحظر محاولات إنفاق رصيد لا تملكه عبر استجابات 402. يمكنك إنشاء مفتاح جديد فوراً من لوحة التحكم، ويصبح المفتاح القديم غير نشط على الفور.

إرسال طلب إكمال الدردشة

أرسل طلب POST إلى /v1/chat/completions مع سجل رسائلك. معرف النموذج هو "uncensored" ويقبل المعلمات القياسية مثل temperature و top_p. يعمل هذا الإعداد مع أي عميل يدعم بروتوكول OpenAI، بما في ذلك Cursor وأدوات المطورين الآخرين.

Copycurl https://api.modelapis.cc/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "get current unix timestamp"}]
  }'

تحقق من الاستجابة لـ content field داخل رسالة المساعد. إذا تجاوزت حد معدلك، تعيد واجهة برمجة التطبيقات رمز حالة 429. يمكنك مراقبة رصيدك المتبقي مباشرة في لوحة التحكم dashboard دون الحاجة إلى تحليل الرؤوس يدويًا.

استجابات البث عبر SSE

فعّل البث عن طريق تعيين stream: true في جسم الطلب الخاص بك. تُعيد الواجهة البرمجية (API) أحداث الإرسال من الخادم (SSE) التي تحتوي على شرائح نصية جزئية. هذا الأسلوب مثالي لبناء واجهات دردشة تعرض النص أثناء توليده.

Copyfrom openai import OpenAI

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

يحتوي كل جزء فقط على جزء من الاستجابة النهائية. يتضمن الجزء الأخير إحصائيات استخدام الرموز الكاملة للطلب. يتيح لك ذلك تتبع التكاليف في الوقت الفعلي دون انتظار انتهاء التوليد بالكامل.

استدعاء الوظائف والأدوات

عرّف أدواتك في tools السماح واضبط tool_choice إلى auto. يعيد النموذج استدعاءات أدوات منظمة عند الاقتضاء، مما يتيح لتطبيقك تنفيذ الوظائف الخارجية. تعمل هذه الميزة بسلاسة مع مكتبات SDK القياسية من OpenAI.

Copyimport OpenAI from "openai";

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

تحليل الـ tool_calls مصفوفة في رسالة المساعد لتشغيل منطق الخلفية الخاص بك. يمكنك بعد ذلك إعادة تغذية النتائج في المحادثة كاستجابات للأدوات. يتيح هذا الدورة عمليات عمل واعدة معقدة دون مغادرة الواجهة البرمجية.

فرض وضع JSON

تعيين response_format إلى {"type": "json_object"} لفرض خروج النموذج بصيغة JSON صالحة. هذا أمر بالغ الأهمية للتطبيقات التي تقوم بتحليل الاستجابة برمجيًا. سالتزم النموذج بهذا القيد بدقة.

استخدم هذا الوضع عندما تحتاج إلى هياكل متوقعة لخطوط بياناتك. يقلل من الحاجة إلى خدع التعبيرات العادية للمعالجة اللاحقة. يبقى النموذج غير خاضع للرقابة حتى في وضع JSON، مما يسلم البيانات الخام دون فلاتر المحتوى.

حدود الرموز ونافذة السياق

تدعم نافذة السياق ما يصل إلى 100,000 رمز مرمز لمجموع النص الوارد والإجابة المولدة معاً. يمكنك طلب ما يصل إلى 16,000 رمز مرمز للإخراج في كل طلب. إذا لم تحدد max_tokens, الافتراضي هو 2,048 رمزًا.

محدودة الطلبات بـ 300 في الدقيقة لكل مفتاح. الحد الأقصى لحجم جسم الطلب هو 8 ميجابايت. تضمن هذه الحدود أداءً مستقراً للاستخدام عالي الحجم. لا تستهلك الأخطاء والرفض رصيدك المدفوع مسبقاً، لذا تدفع فقط مقابل التوليدات الناجحة.

التدفق

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)