الإجابة المختصرة
العبارة image gen api openai قد تعني شيئين مختلفين، ومن المفيد فصلهما. أحدهما هو خدمة توليد الصور الخاصة بـ OpenAI، التي تتبع لـ OpenAI وتصل إليها بحساب OpenAI. الآخر هو أي خدمة تنسخ تنسيق طلب OpenAI لتبقى أدوات وواجهات برمجة التطبيقات (SDKs) الحالية تعمل. هذا الموقع هو النوع الثاني، والنص فقط.
ما تحصل عليه هنا هو واجهة برمجة تطبيقات (API) لنموذج لغوي كبير (LLM) للنص، بدون رقابة. تشير إلى عنوان URL الأساسي أدناه باستخدام عميل OpenAI، وتضبط النموذج على uncensored، وتتلقى إكمال الدردشة. لا تعود أي بكسلات. لا يوجد توليد صور أو صوت أو فيديو، ولا تضمينات (embeddings)، ولا ضبط دقيق (fine-tuning)، ولا يُخطط لأي من ذلك كجزء مما هو موصوف في هذه الصفحات.
ما هو متوافق وما هو غير متوافق
كلمة "متوافق" تُستخدم بشكل مبالغ فيه في التسويق، لذا إليك التفاصيل الدقيقة. عنوان URL الأساسي هو https://api.imagegenapi.com/v1، والمصادقة تكون عبر Authorization: Bearer <key>، وطريقتان موجودتان.
| نقطة النهاية | متاح هنا | ملاحظات |
|---|---|---|
POST /v1/chat/completions | نعم | البث المتدفق، استدعاء الدوال، وضع JSON |
GET /v1/models | نعم | يعرض uncensored |
| نقاط نهاية لتوليد الصور | لا | خدمة نصوص فقط |
| التضمين (Embeddings)، الصوت، الضبط الدقيق (Fine-tuning) | لا | غير متوفر |
إذا استدعى الكود مسار صورة على هذا العنوان الأساسي، فانتظر خطأً وليس صورة. ينطبق الأمر نفسه على أي ميزة من OpenAI خارج الطريقتين المذكورتين أعلاه. أدوات التحكم في العيّنات التي تعرفها تعمل: temperature، top_p، stop، seed، وتُمرر معاملات العقوبة، ويمكن أن تستخدم الاستجابة نافذة السياق الكاملة المكونة من 100,000 رمز بين الموجّه والإكمال.
من الجدير أيضاً توضيح الهوية. النموذج خلف uncensored هو نموذج مفتوح الأوزان واحد، تديره جهة مستقلة. هذه ليست واجهة برمجة تطبيقات (API) من OpenAI، ولا تقوم بإعادة توجيه نماذج OpenAI، ولا تنتمي إلى OpenAI. الصفحة المطابقة في هذا الموقع، GPT image API and uncensored text، تغطي هذا التمييز من زاوية أسماء نماذج الصور.
لماذا يظهر هذا السؤال
يصل الناس إلى صفحات مثل هذه لأسباب مفهومة. أدوات الصور تعتمد على موجّهات (prompts) نصية، وتُكتب الموجّهات النصية بواسطة نماذج لغوية، وتشارك العديد من بوابات نماذج اللغة نموذج طلب واحد. التخمين الطبيعي هو أن واجهة برمجة تطبيقات (API) واحدة تقوم بالكل.
في الممارسة العملية، الوظيفتان نظامان منفصلان بمفاتيح منفصلة، وأسعار منفصلة وقواعد منفصلة. خدمة الصور تأخذ موجهاً (prompt) وتعيد صورة. خدمة النصوص تأخذ رسائل وتعيد المزيد من النصوص. الرابط بينهما هو أنت، أو سكريبت تكتبه، لنقل النص من واحد إلى الآخر. بمجرد أن ترى الأمر بهذه الطريقة، يتغير السؤال المفيد من "هل تصنع هذه الواجهة البرمجية (API) صوراً" إلى "هل يمكن لهذه الواجهة البرمجية (API) كتابة موجّهات (prompts) أفضل لنموذج الصور الذي أستخدمه بالفعل".
هذه حالة استخدام حقيقية، ومكان يمكن أن يكون فيه نموذج نصي بدون رقابة ذا أهمية. غالباً ما يعيد المساعِدون ذوو الأغراض العامة صياغة طلبات الموجّه أو تخففها أو ترفضها عندما تتعلق بمواضيع الخيال الأدبي للبالغين، أو العنف في إعداد القصة، أو الجماليات المظلمة. النموذج الذي يُضبط للإجابة على طلبات البالغين القانونية بدون رفض سيقوم عادةً بمهمة الكتابة كما هو مطلوب. الحد الصلب يبقى قائماً: لا محتوى جنسي يتضمن القاصرين، تحت أي إطار.
استخدام واجهة برمجة التطبيقات (API) للنصوص لكتابة موجّهات (prompts) للصور
إليك مثال صغير وعملي. يطلب النموذج موجهاً (prompt) مفصلاً، ثم تلصقه في أي مولد صور تستخدمه. يستخدم الكود واجهة برمجة التطبيقات (SDK) الرسمية لـ Python الخاصة بـ OpenAI ضد عنوان URL الأساسي هذا.
from openai import OpenAI
client = OpenAI(base_url="https://api.imagegenapi.com/v1", api_key="YOUR_KEY")
reply = client.chat.completions.create(
model="uncensored",
temperature=0.8,
messages=[
{"role": "system", "content": "You write prompts for text-to-image models. Reply with one paragraph: subject, composition, lighting, palette, lens or style. No preamble."},
{"role": "user", "content": "A ruined lighthouse at dusk for a dark fantasy book cover."},
],
)
print(reply.choices[0].message.content)نفس الاستدعاء من سطر الأوامر:
curl 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 one-paragraph image prompt: a ruined lighthouse at dusk, dark fantasy cover art."}]}'جعل المخرجات قابلة للاستخدام
تختلف مولّدات الصور في ما تقبله، لذا شكّل النتيجة باستخدام رسالة النظام. اطلب بنية ثابتة، حدًا للكلمات، وقائمة بالأشياء التي يجب تجنبها. إذا كنت بحاجة إلى الموجّه داخل خط أنابيب، اطلب JSON مع ضبط response_format إلى النوع json_object واطلب مفاتيح مثل prompt و negative. ثم قم بتحليلها ومرر الحقول إلى عميل الصور الخاص بك. ضبط seed ودرجة حرارة منخفضة temperature يعطي إخراجًا أكثر تكرارًا عند التكرار في الصياغة.
سير عمل دفعي بأرقام حقيقية
افترض أنك تولد موجّهات لـ 1,000 مشهد. كل طلب يرسل حوالي 300 رمز (تعليمات بالإضافة إلى ملاحظة مشهد قصيرة) ويتلقى إكمالاً من حوالي 200 رمز. التسعير هو $0.15 لكل مليون رمز مدخل و $0.50 لكل مليون رمز مخرج.
- طلب واحد، مدخل: 300 / 1,000,000 × $0.15 = $0.000045.
- طلب واحد، الناتج: 200 / 1,000,000 × $0.50 = $0.0001.
- إجمالي طلب واحد: $0.000145.
- 1,000 طلب: 1,000 × $0.000145 = $0.145.
لذا فإن ألف موجّه تكلف حوالي 14.5 سنتاً، وخطوة النص هي عادةً جزء صغير من الفاتورة مقارنة بإنشاء الصور نفسه، الذي يجب عليك التحقق من سعره مع مزود الخدمة. مفتاح كامل يسمح بـ 8 طلبات متزامنة و300 طلب في الدقيقة، لذا فإن 1,000 طلب تتسع في بضع دقائق مع مجموعة عمال صغيرة. تعامل مع HTTP 429 بالانتظار؛ رأس Retry-After: 5 يخبرك كم من الوقت في الحمل الزائد المؤقت.
يمكنك تجربة كل هذا دون دفع. بعد التسجيل، تحتوي صفحة مفتاح API على رصيد تجريبي مجاني بقيمة $0.50 بنقرة واحدة، صالح لمدة 7 أيام. على المدى الطويل، تتراوح عمليات شحن الرصيد من $20 إلى $500 وتُدفع بالعملات المشفرة (USDT على TRC20 أو USDC على Base)؛ راجع التسعير لتفاصيل مستويات المكافآت.
أخطاء يجب تجنبها
تظهر بعض الأخطاء مرارًا وتكرارًا عندما يحاول شخص استخدام نقطة نهاية على طراز OpenAI لأعمال الصور.
- استدعاء مسار صورة وتوقع صورة. توجد طريقتان موثقتان فقط هنا. تحقق من نص استجابة الخطأ بدلاً من إعادة المحاولة، لأن إعادة المحاولة لن تغير النتيجة.
- طلب من نموذج النص "رسم" شيء ما. قد يجيب بفن ASCII أو بوصف أو باعتذار. إذا كنت تريد صورة، أرسل الموجّه الذي يكتبه إلى مولد صور حقيقي.
- تخطي قائمة النماذج. تأكيد عمل المفتاح وأن النموذج الوحيد هو
uncensoredعبر استدعاءGET /v1/modelsسريع. لا يكلف شيئاً. - تجاهل استجابات 429. يسمح المفتاح التجريبي بطلبين متزامنين، لذا ستفشل حلقة تكرارية بعشرة عمال (workers) بسرعة. قم بتقييد عدد العمال أو أضف انتظارًا قصيرًا.
- إرسال body كبير جداً. الحد هو 8 MB لكل طلب. استدعاءات كتابة الموجّه صغيرة، لذا نادراً ما يهم هذا، لكن المستندات المنسوخة قد تصل إلى هذا الحد.
لا شيء من هذه يصعب إصلاحه، وأقصر علاج هو سكريبت اختبار من عشرة أسطر يتم تشغيله قبل ربط أي شيء بأداة أكبر.
عندما تكون خدمة أخرى هي الأنسب
كن عمليًا بشأن الاختيار. إذا كنت تحتاج إلى الصورة نفسها، فأنت بحاجة إلى مزود صور، وOpenAI هو أحد عدة مزودين؛ انظر إلى وثائقه الحالية وأسعاره لمعرفة تفاصيل ما يقدمه. إذا كان هدفك الوحيد هو الحصول على موجّه نظيف بأسلوب سائد، فقد يكون المساعد القياسي كافيًا ولن تحتاج إلى هذه الخدمة على الإطلاق.
هذه API هي الأنسب عندما تكون خطوة النص هي عنق الزجاجة: عندما يرفض مساعدك أو يخفف من طلبات الموجّه، أو تحتاج إلى حجم كبير من الموجّهات بسعر قابل للتنبؤ لكل رمز، أو تريد نقطة نهاية متوافقة مع OpenAI لأدوات الخيال الأدبي، ولعب الأدوار، وأدوات المرافقة (companion) للاستخدام القانوني للبالغين دون إعادة كتابة كود العميل. للتفاصيل الكاملة للمعاملات، تحتوي الوثائق على تنسيق الطلب وأكواد الأخطاء.
ملاحظة عملية أخرى: لا تُستخدم الموجّهات المرسلة إلى هذه API للتدريب. ومع ذلك، تعامل مع أي خدمة مستضافة على أنها خارج جهازك وتجنب إرسال أسرار لن تلصقها في نموذج ويب.
