شرح واضح لواجهة إنشاء الصور واختيار النموذج وإعداد المعلمات وطرق الاستدعاء.

أصبحت إمكانات إنشاء الصور باستخدام نماذج Guishu الكبيرة متاحة الآن. سواء كنت تريد غلافًا لمنشور WeChat الرسمي، أو صورة توضيحية لمنتج، أو أيقونة تطبيق، أو صورة سلعة، أو إنشاء صور تلقائيًا عبر Agent، يمكنك توليدها مباشرةً من خلال واجهة موحدة. واجهة إنشاء الصور: POST https://api.llm-token.cn/v1/images/generations

أولًا: الخلاصة — جهّز هذه العناصر الثلاثة وابدأ الاستخدام ✨

ما تحتاج إلى تحضيره	طريقة الإدخال
مفتاح Guishu Token	أدخل `Authorization: Bearer 你的new-api-token` في ترويسة الطلب
واجهة إنشاء الصور	`https://api.llm-token.cn/v1/images/generations`
نموذج إنشاء الصور	`image-01` أو `image-01-live`

وحّدت نماذج Guishu الكبيرة تكامل النماذج ومواءمة الواجهات وإدارة الحصص وقواعد الفوترة. ما عليك سوى استخدام مفتاح Guishu Token الخاص بك لاستدعاء إمكانات إنشاء الصور من واجهة واحدة.

ثانيًا: شغّل أول طلب خلال 1 دقيقة — مثال curl 🚀

استبدل YOUR_NEW_API_TOKEN أدناه بمفتاح Guishu Token الخاص بك لتتمكن من الاختبار مباشرةً.

curl https://api.llm-token.cn/v1/images/generations \
  -H "Authorization: Bearer YOUR_NEW_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "image-01",
    "prompt": "一张可爱的蓝色 AI 小机器人图标，白色背景，极简 3D 风格，居中构图，不要文字",
    "response_format": "url",
    "n": 1,
    "aspect_ratio": "1:1",
    "prompt_optimizer": false
  }'

في الاختبار الأول، يُنصح بإنشاء 1 صورة، أي n: 1. وبعد التأكد من نجاح إنشاء الصورة، عدّل النسبة والنمط والعدد حسب الحاجة.

ثالثًا: كيف تُدخل معلمات الطلب؟ 🧩

المعلمة	مطلوبة	القيمة الشائعة	الشرح
`model`	نعم	`image-01`	اسم نموذج إنشاء الصور. ويمكنك أيضًا إدخال `image-01-live` إذا احتجت إلى إمكانات إنشاء صور أكثر آنية.
`prompt`	نعم	أدخله حسب متطلبات الصورة	صِف الصورة التي تريد إنشاءها. يُنصح بتوضيح الموضوع والنمط والألوان والتكوين والغرض.
`response_format`	لا	`url`	يُنصح باستخدام `url` لإرجاع رابط الصورة مباشرةً؛ ويمكن أيضًا استخدام `base64` وفق احتياجات العمل.
`n`	لا	`1`	عدد الصور التي تُنشأ في المرة الواحدة. يُنصح بإدخال `1` أولًا في الاختبارات المعتادة.
`aspect_ratio`	لا	`1:1`	نسبة أبعاد الصورة. القيم الشائعة: `1:1` و`16:9` و`9:16` و`4:3` و`3:4` و`21:9`.
`prompt_optimizer`	لا	`false`	تحديد ما إذا كان تحسين الموجّه مفعّلًا. إذا أردت إنشاء الصورة وفق النص الأصلي بدقة أكبر، فيُنصح بإدخال `false`.
`seed`	لا	عدد صحيح	يُستخدم لتحسين قابلية إعادة إنتاج النتيجة. يمكنك تثبيت قيمة seed نفسها عند الحاجة إلى نتائج متقاربة في عدة عمليات إنشاء.
`width` / `height`	لا	غير مطلوب عادةً	يكفي استخدام `aspect_ratio` مباشرةً في معظم الحالات؛ ولا تمررهما إلا عند الحاجة إلى عرض وارتفاع دقيقين.

إذا كانت النتيجة عبارة عن URL للصورة، فيُنصح بحفظها فور إنشائها. رابط الصورة مناسب للمعاينة والتنزيل المؤقتين، ولا يُنصح باستخدامه مصدرًا دائمًا للمواد.

رابعًا: لماذا تجعل نماذج Guishu الكبيرة الاستخدام أسهل؟ 🍬

يتطلب التكامل المعتاد غالبًا التنقل بين منصات نماذج متعددة، لكل منها مفاتيح وواجهات وطرق فوترة مختلفة، ما يجعل التطوير والصيانة أكثر تعقيدًا.

وحّدت نماذج Guishu الكبيرة كل ذلك. تحتاج فقط إلى مفتاح Guishu Token واحد لاستدعاء إمكانات إنشاء الصور عبر واجهة موحدة؛ كما تُعتمد بيانات الاستخدام والمضاعِفات والرصيد المعروضة في لوحة Guishu Token، فتكون واضحة وسهلة الإدارة.

الإمكانية	الشرح
واجهة موحدة	تمر جميع طلبات إنشاء الصور عبر `https://api.llm-token.cn/v1/images/generations`، ما يجعل التكامل أبسط.
مفتاح موحد	استخدم `new-api-token` المُنشأ في لوحة Guishu Token دون الحاجة إلى التبديل بين منصات متعددة.
فوترة موحدة	تُعتمد بيانات الاستخدام والمضاعِفات والرصيد المعروضة في لوحة Guishu Token، ما يسهّل على الفريق إدارة التكلفة.
مناسب للتكامل في الأعمال	مناسب لصور منشورات WeChat الرسمية وصور السلع وأغلفة المنتجات وإنشاء الصور تلقائيًا عبر Agent وتوليد المواد بكميات كبيرة وغيرها من السيناريوهات.

باختصار: استخدم Guishu Token وواجهة واحدة لدمج إمكانات إنشاء الصور في منتجك وسير عملك.

خامسًا: كيف تستخدم image-01-live؟ ⚡

يستخدم image-01-live واجهة إنشاء الصور نفسها. تبقى المعلمات الأخرى دون تغيير، وما عليك سوى تغيير model إلى image-01-live.

{
  "model": "image-01-live",
  "prompt": "一张赛博风格的蓝色产品宣传图，干净背景，科技感，适合公众号封面",
  "response_format": "url",
  "n": 1,
  "aspect_ratio": "16:9",
  "prompt_optimizer": false
}

إذا كان هذا النموذج مفعّلًا في حسابك، فيمكنك استدعاؤه بهذه الطريقة مباشرةً.

سادسًا: مثال Python للاستخدام داخل مشروعك 🐍

import requests

url = "https://api.llm-token.cn/v1/images/generations"
headers = {
    "Authorization": "Bearer YOUR_NEW_API_TOKEN",
    "Content-Type": "application/json",
}
payload = {
    "model": "image-01",
    "prompt": "一张科技感很强的蓝色应用图标，白色背景，极简 3D 风格，居中构图，不要文字",
    "response_format": "url",
    "n": 1,
    "aspect_ratio": "1:1",
    "prompt_optimizer": False,
}

resp = requests.post(url, headers=headers, json=payload, timeout=120)
resp.raise_for_status()
print(resp.json())

يستغرق إنشاء الصور وقتًا أطول من المحادثات النصية العادية؛ لذلك يُنصح بضبط مهلة العميل على نحو 120 ثانية لتجنب قطع الطلب من جانب العميل قبل اكتمال إنشاء الصورة.

سابعًا: كيف تصف الصورة للحصول على نتيجة أفضل؟ 🪄

عند وصف الصورة، يمكنك الكتابة بالترتيب التالي للحصول على نتائج أكثر استقرارًا:

الموضوع: ما الذي تريد رسمه، مثل «روبوت ذكاء اصطناعي أزرق» أو «ملصق لتحليلات كأس العالم».
المشهد: أين يوجد الموضوع، مثل «خلفية بيضاء» أو «تحت أضواء الملعب» أو «سطح مكتب».
النمط: بسيط، واقعي، 3D، رسم توضيحي، ملصق تجاري، طابع فوتوغرافي، وغيرها.
التكوين: في المنتصف، منظور علوي، نصف الجسم، مساحة فارغة، غلاف أفقي، وغيرها.
الألوان: اللون الأساسي والألوان المساعدة، مثل الأزرق والأبيض، أو الأسود والذهبي، أو تباين الأحمر والأزرق.
القيود: مثل «دون نص» أو «دون علامة مائية» أو «خلفية نظيفة».

يمكنك استخدام هذا القالب الصغير مباشرةً:

一张【比例】的【用途】图片，主体是【主体】，场景是【场景】，整体风格为【风格】，主色为【颜色】，构图【构图要求】，细节要求【限制或补充】。

مثال:

一张 1:1 的应用图标，主体是蓝色发光的 AI 芯片，白色背景，极简 3D 风格，居中构图，边缘清晰，不要文字。

ثامنًا: عند مواجهة مشكلة، ابدأ من هنا 🛟

العَرَض	طريقة المعالجة
ظهور خطأ في المصادقة	تحقق من أن ترويسة الطلب مكتوبة هكذا: `Authorization: Bearer YOUR_NEW_API_TOKEN`، وتأكد من عدم نسخ مسافات زائدة مع الرمز (token).
ظهور رسالة بأن النموذج غير موجود	تحقق من كتابة اسم النموذج حرفيًا بصيغة `image-01` أو `image-01-live`، ولا تغيّر حالة الأحرف.
نسبة الصورة لا تطابق المتوقع	عدّل `aspect_ratio` أولًا. يمكنك استخدام `16:9` لأغلفة منشورات WeChat الرسمية الشائعة، و`1:1` للصورة الشخصية أو الأيقونة.
تعذر فتح رابط الصورة	ربما انتهت صلاحية URL الصورة. يُنصح بتنزيل الصورة فور إنشائها أو نقلها إلى مكتبة المواد الخاصة بك.
يستغرق الطلب وقتًا طويلًا	يحتاج إنشاء الصور بطبيعته إلى وقت؛ لذلك يُنصح بضبط مهلة الطلب على أكثر من 120 ثانية.
نتيجة الإنشاء غير مستقرة بما يكفي	اكتب المتطلبات بمزيد من التحديد وقلّل الأوصاف المتعارضة؛ ويمكنك تثبيت `seed` عند الحاجة إلى نتائج متقاربة.

تاسعًا: نسخة جاهزة لإرسالها مباشرةً إلى فريق التطوير 📮

نستدعي إمكانات إنشاء الصور عبر نماذج Guishu الكبيرة باستخدام الواجهة POST https://api.llm-token.cn/v1/images/generations. استخدم Authorization: Bearer YOUR_NEW_API_TOKEN في ترويسة الطلب، وأدخل model: image-01 أو model: image-01-live في جسم الطلب، ثم مرّر معلمات مثل prompt وresponse_format: url وn وaspect_ratio.

عاشرًا: ما السيناريوهات المناسبة؟ 📚

السيناريو	طريقة الاستخدام
صور منشورات WeChat الرسمية / Xiaohongshu	إنشاء الأغلفة والصور الرئيسية وملصقات الفعاليات والرسوم التوضيحية للمقالات بسرعة.
صفحات المنتجات وSaaS	إنشاء أيقونات التطبيقات وصور الميزات واللافتات ورسوم الحالات الفارغة.
التجارة الإلكترونية ومواد السلع	إنشاء صور خلفيات السلع والصور الترويجية وصور الأجواء لصفحات التفاصيل.
سير العمل المؤتمت عبر Agent	تمكين الوكيل من إنشاء صور توضيحية تلقائيًا وفق المحتوى لرفع كفاءة إنتاجه.

Your privacy choices

دليل إنشاء الصور باستخدام نماذج Guishu الكبيرة