واجهة برمجة تطبيقات Stable Diffusion: الموجّهات والسكربتات عبر نقطة نهاية واحدة

الوصول إلى واجهة برمجة التطبيقات باستخدام عنوان URL الأساسي https://api.sdxlapi.com/v1. هذه النقطة متوافقة تمامًا مع حزم SDK والعملاء القياسيين لـ OpenAI. للمصادقة، مرر مفتاح API الخاص بك في رأس Authorization لكل طلب.

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

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

Copycurl https://api.sdxlapi.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."}]
  }'

تقبل الـ API حمولات JSON تحتوي على مصفوفة messages. تُرجع إكمال نص. يمكنك تمرير موجّهات النظام لتحديد الشخصية، مثل مهندس موجّهين محترف لإنشاء الصور.

استخدم حزمة Python الرسمية openai. قم بتكوين العميل باستخدام عنوان URL الأساسي ومفتاح API الخاص بك. يعمل هذا النهج مع أي عميل متوافق مع OpenAI.

Copyfrom openai import OpenAI

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

تحتوي الاستجابة على النص المُولّد في response.choices[0].message.content. يمكنك تحليل هذا الإخراج مباشرة في خط الأنابيب الخاص بك لاستخراج التسميات التوضيحية أو البيانات الوصفية. تتعامل حزمة SDK مع التسلسل الهرمي لـ JSON وتفاصيل HTTP تلقائيًا.

لمشاريع JavaScript أو TypeScript، استخدم حزمة npm openai. اضبط baseURL وapiKey في كائن التكوين. يضمن ذلك التوافق مع مستودعات الكود OpenAI الموجودة.

Copyimport OpenAI from "openai";

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

هيكل الاستجابة يعكس التنسيق القياسي لـ OpenAI. الوصول إلى النص المُولّد عبر response.data.choices[0].message.content. هذا مفيد لتوليد الموجّهات من جانب الخادم قبل إرسال الصور إلى مثيل Stable Diffusion.

يدعم Server-Sent Events (SSE) استلام الرموز (token) أثناء توليدها. يقلل هذا من زمن الاستجابة المُدرَك في سكريبتات الموجّهات الطويلة أو الوصف التفصيلي.

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)

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

حدود المعدل: 300 طلب في الدقيقة لكل مفتاح. حجم الجسم: الحد الأقصى 8 ميجابايت. نافذة السياق: 100,000 رمز إجماليًا (الإدخال + الإخراج). هذا يسمح بسكربتات طويلة أو هندسة موجّهات واسعة النطاق.

الأخطاء الشائعة:

• 401 Unauthorized: مفتاح API غير صالح أو مفقود.
• 402 Payment Required: رصيد مسبق الدفع غير كافٍ.
• 429 Too Many Requests: تجاوز حدّ المعدل.

إذا تجاوزت الحدود، انتظر قليلاً أو أعد إنشاء مفتاحك. جميع الطلبات للنصوص فقط؛ لا يتم توليد الصور أو الصوت أو الفيديو بواسطة واجهة برمجة التطبيقات هذه.