Models api quickstart guide

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

عنوان الـ API هو https://api.modelsapi.cc/v1. تتطلب جميع الطلبات مفتاح API صالح يُمرر في Authorization الرأس. تنشئ هذا المفتاح في لوحة التحكم بالنقر على 'احصل على مفتاح API'. يظهر فورًا بعد تسجيلك عبر Google أو البريد الإلكتروني. لا يلزم رقم هاتف لهذه العملية. المفتاح مرتبط برصيد حسابك وحدود الاستخدام.

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

أرسل طلب POST إلى /v1/chat/completions باستخدام معرف النموذج uncensored. يجب أن يتضمن جسم الطلب messages مصفوفة تحتوي على طلبك. تُعيد الواجهة البرمجية استجابة نصية مباشرة. لا تستهلك الأخطاء رصيدك المدفوع مسبقًا. يمكنك التحقق من عمل نقطة النهاية بإرسال تحية بسيطة.

Copycurl https://api.modelsapi.cc/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "List five python libraries for data visualization"}]
  }'

تكامل مكتبة Python

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

Copyfrom openai import OpenAI

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

يتبع SDK لـ Node.js نفس نمط التكوين. استورد حزمة OpenAI وقم بتكوين عنوان URL الأساسي. مرر مفتاح API الخاص بك في كائن التكوين. يسمح هذا الإعداد لك باستخدام الأساليب المألوفة لتوليد النص. تتعامل المكتبة مع طلبات HTTP تلقائياً.

Copyimport OpenAI from "openai";

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

استجابات التدفق عبر أحداث الإرسال عبر الخادم (SSE)

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

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)

حدود، أخطاء، ونافذة السياق

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