دليل البدء السريع لـ Da Moxing API

المتطلبات المسبقة: تثبيت SDK

لبدء استخدام Da Moxing API بسرعة، تحتاج إلى تثبيت SDK متوافق مع الرسمي. نظرًا لأن نقاط النهاية لدينا متوافقة تمامًا مع بروتوكول OpenAI، يمكنك استخدام المكتبات التي تعتاد عليها مباشرة. لمطوري Python، نوصي باستخدام مكتبة openai؛ ولمطوري Node.js، استخدم حزمة npm openai. تأكد من تثبيت هذه التبعيات في بيئة عملك لإجراء استدعاءات API لاحقًا.

تكوين نقطة النهاية

قبل إرسال الطلب، يجب تكوين base_url ليكون عنوان الخادم الخاص بنا. يضمن ذلك توجيه طلبك بشكل صحيح إلى نموذج بدون رقابة. قم بتعيين base_url إلى https://api.apidamoxing.com/v1. هذا هو الأساس لجميع استدعاءات API، وتأكد من أن إصدار SDK الذي تستخدمه يدعم تكوين عنوان URL الأساسي المخصص.

إنشاء مفتاح API

قم بزيارة صفحة "الحصول على مفتاح API"، وسجّل حسابًا باستخدام البريد الإلكتروني وكلمة المرور. بعد إتمام التسجيل، سيظهر مفتاح API على الشاشة على الفور. يرجى حفظ هذا المفتاح بعناية، لأنه سيستخدم للمصادقة في جميع طلبات API. يمكن أن يحتوي كل حساب على مفتاح رئيسي واحد فقط، ولكن يمكنك إنشاء مفاتيح جديدة في أي وقت، وسيصبح المفتاح القديم غير صالح على الفور.

إرسال الطلب الأول

أرسل طلبك الأول باستخدام cURL للتحقق من أن API يعمل بشكل صحيح. سيتم إرسال الطلب إلى نموذج uncensored، وسيعيد محتوى نصي غير مصفى. يرجى التأكد من استبدال YOUR_API_KEY بمفتاحك الفعلي. يوضح هذا الطلب قدرة توليد النص الأساسية، وهو مناسب لمختلف سيناريوهات الإبداع الحر.

复制curl https://api.apidamoxing.com/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."}]
  }'

دعم الإخراج المتدفق (SSE)

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

复制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 الخاص بنا وظيفة استدعاء الأدوات، مما يسمح للنموذج بالتفاعل مع الدوال الخارجية. من خلال تعريف معلمة tools، يمكنك جعل النموذج يستدعي دالة محددة بناءً على السياق. هذا مفيد جدًا عند بناء مساعدين ذكيين أو سير عمل تلقائي. تأكد من أن تعريف الأدوات يتوافق مع مواصفات استدعاء الدوال الخاصة بـ OpenAI لتحقيق أفضل توافق.

复制from openai import OpenAI

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

复制import OpenAI from "openai";

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