بداية سريعة: واجهة برمجة تطبيقات للنصوص غير الخاضعة للرقابة لخطوط إنتاج الصور

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

تتبع واجهة برمجة التطبيقات هيكل chat-completions القياسي لـ OpenAI. للبدء، انتقل إلى صفحة الحصول على مفتاح API وقم بالتسجيل باستخدام البريد الإلكتروني وكلمة المرور. يظهر مفتاح API على الفور. لا يلزم رقم هاتف أو بطاقة ائتمان للتجربة، على الرغم من أن رصيد مسبق الدفع مطلوب للاستخدام المستمر.

قم بتعيين عنوان URL الأساسي الخاص بك إلى https://api.imagegenapi.com/v1. قم بتضمين مفتاح API الخاص بك في رأس Authorization كرمز Bearer. يعمل هذا الإعداد مع أي مكتبة عميل متوافقة مع OpenAI. معرف النموذج الذي يجب استخدامه هو uncensored، وهو نموذج مفتوح الأوزان مضبوط للإجابة بدون رفض للاستخدام القانوني للبالغين.

إرسال الموجّه

أرسل طلب chat.completions قياسي لتوليد النص. تقبل واجهة برمجة التطبيقات قائمة بالرسائل في مصفوفة messages. إنها تُرجع كائن JSON يحتوي على الإكمال. هذا مثالي لتوليد الموجّه لمرة واحدة أو مهام تحرير البيانات الوصفية حيث لا يلزم البث.

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

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

تكامل SDK لـ Python

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

Copyfrom openai import OpenAI

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

قم بتهيئة العميل بمفتاحك وعنوان URL الأساسي الصحيح. اتصل بـ chat.completions.create() مع رسائلك. هذا النهج هو الأفضل للمعالجة الدفعية أو عندما تحتاج إلى تحليل استجابة JSON مباشرةً في منطق التطبيق الخاص بك. تذكر أن معرف النموذج يجب أن يكون uncensored.

استخدام SDK لـ Node.js

يمكن لمطوري Node.js استخدام حزمة npm openai. قم بتعيين baseURL إلى نقطة النهاية الخاصة بنا. هذا مفيد للعرض من جانب الخادم أو بوابات API حيث تحتاج إلى معالجة استجابات النص بشكل غير متزامن.

Copyimport OpenAI from "openai";

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

أنشئ مثيل العميل بمفتاح API الخاص بك وعنوان URL الأساسي. استدعِ chat.completions.create() للحصول على إخراج النص. هذه الطريقة مناسبة لتوليد النصوص البرمجية أو الأوصاف أو استخراج المعلومات من النص قبل استخدامها في خط إنتاج الصور الخاص بك.

الاستجابات المتدفقة

لتوليد النص في الوقت الفعلي، قم بتمكين البث المتدفق عن طريق تعيين stream: true. تُرجع واجهة برمجة التطبيقات تدفق أحداث الإرسال من الخادم (SSE)، وليس كائن JSON واحدًا. يجب عليك التعامل مع أجزاء delta عند وصولها لإعادة بناء الرسالة الكاملة.

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)

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

حدود المعدل والقيود

يُحدّ كل مفتاح API بـ 300 طلب في الدقيقة. يجب ألا يتجاوز حجم جسم الطلب 8 MB. إذا تجاوزت الحدّ، ستتلقى خطأ 429. أعد إنشاء المفتاح إذا لزم الأمر، مما يلغي المفتاح القديم.

إذا استنفد رصيدك مسبق الدفع، فسترفض واجهة برمجة التطبيقات الطلبات. لا توجد طبقة مجانية غير محدودة؛ يجب عليك شحن الرصيد. يشير الخطأ 401 إلى مفتاح API غير صالح أو مفقود. تأكد من تعيين مفتاحك بشكل صحيح في رأس المصادقة. نافذة السياق هي 100,000 رمز للموجّه بالإضافة إلى الإكمال.