Zhipu: CogView 4
CogView 4 نموذج Zhipu لتحويل النص إلى صورة، وهو متاح في Ailoot Ultra بالمعرّف الدقيق cogview-4. قدّم وصفًا للمشهد لإنشاء رسم توضيحي أو بيئة عرض لمنتج أو تصور بصري. تتضمن عناصر التحكم الموثّقة حجم الصورة، والجودة standard أو hd، وwatermark_enabled؛ وتوفّر الاستجابة عناوين URL للصور ينبغي حفظها كلها.
عن النموذج
يغطي هذا الوصف قدرات النموذج. وترد أدناه المدخلات والمخرجات والخيارات المتاحة في Ailoot للطريقة المحددة.
يحوّل CogView 4 موجزًا مكتوبًا للصورة إلى صور ناتجة. اختر cogview-4 في POST /v1/images/generations وقدّم prompt كسلسلة نصية. المدخلان المطلوبان هما model وprompt. استخدم الموجز لوصف الموضوع الرئيسي وموضعه والمشهد المحيط والمعالجة البصرية التي تريد تقييمها.
لبيئة عرض منتج، صِف العنصر والسطح الذي تحته والخلفية واتجاه الضوء. ولرسم توضيحي، حدّد الشخصيات أو العناصر والأجواء المقصودة والتكوين. وإذا كانت الصورة ستوضع بجوار عنوان أو وصف منتج، فحدّد أين ينبغي أن يترك التكوين مساحة خالية. راجع النتيجة وفق هذه المتطلبات الملموسة قبل استخدامها في تصميم.
تسرد إرشادات الحجم الخاصة بـ CogView القيم 1024x1024 و768x1344 و864x1152 و1344x768 و1152x864 و1440x720 و720x1440. وتحدد إرشادات الحجم المخصص أن يكون كل جانب بين 512 و2048 بكسل، وقابلًا للقسمة على 16، وألا يتجاوز مجموع البكسلات 2^21. طابِق التأطير مع موضع الاستخدام: فالرسم التوضيحي العمودي ومشهد المنتج المربع والصورة العريضة تتطلب تكوينات مختلفة إلى جانب أبعاد مختلفة.
يقبل quality القيمتين standard أو hd، وتُوثّق standard بوصفها القيمة الافتراضية لـ CogView. watermark_enabled قيمة منطقية، وقيمتها الافتراضية الموثّقة true. تعرّف سلسلة user_id اختيارية المستخدم النهائي ويجب أن تحتوي على 6 إلى 128 محرفًا. أبقِ هذا المعرّف منفصلًا عن الموجّه الإبداعي. ينبغي أن تترافق تغييرات الجودة أو الحجم مع غرض واضح لاستخدام الصورة، بدل أن تحل محل وصف ما ينبغي أن يظهر.
يعيد التوليد استجابة JSON متزامنة تتضمن created وdata. يوفّر كل عنصر data[] قيمة url. نزّل كل صورة مُعادة واحتفظ بالاستجابة مع الموجز والإعدادات المختارة؛ لا تحتفظ بالعنصر الأول فقط لمجرد أن المعاينة تعرض صورة واحدة. لا يقدّم العقد الموثّق خطوة منفصلة لاستطلاع حالة مهمة على غرار الفيديو لطلب الصورة هذا. إذا انقطعت الاستجابة أو كانت ناقصة، فاحتفظ بمعلومات الطلب الأصلي والنتيجة المستلمة قبل تقرير ما إذا كان طلب إنشاء إضافي مناسبًا. يخزّن Ailoot هذه الصور كأصول وسائط مملوكة ويعيد روابط Ailoot موقّعة. اعثر على سجلات الأصول عبر GET /v1/media/assets?family=image، مع متابعة كل next_cursor. اقرأ GET /v1/media/assets/{asset_id} باستخدام كل asset_id فعلي للحصول على content_url الخاص به؛ واقرأ الأصل نفسه مجددًا إذا انتهت صلاحية رابطه الموقّع.
Ailoot Ultra · Images POST /v1/images/generations cogview-4
cogview-4البداية
CogView 4 نموذج Zhipu لتحويل النص إلى صورة، وهو متاح في Ailoot Ultra بالمعرّف الدقيق cogview-4. قدّم وصفًا للمشهد لإنشاء رسم توضيحي أو بيئة عرض لمنتج أو تصور بصري. تتضمن عناصر التحكم الموثّقة حجم الصورة، والجودة standard أو hd، وwatermark_enabled؛ وتوفّر الاستجابة عناوين URL للصور ينبغي حفظها كلها.
- المدخلات المقبولة
- النص
- النتائج
- الصور
متاح في Ailoot · المدخلات والطرائق
Ailoot Ultra · Images POST /v1/images/generations
- الإدخال
text- الإخراج
image- صيغة الإخراج
- ملف صورة
| الحقل | النوع | المتطلب | القيم والحدود | القيمة الافتراضية |
|---|---|---|---|---|
الحقلmodel | النوعstring | المتطلبمطلوب | القيم والحدود cogview-4 | القيمة الافتراضية— |
الحقلprompt | النوعstring | المتطلبمطلوب | القيم والحدود | القيمة الافتراضية— |
الحقلsize | النوعstring | المتطلباختياري | القيم والحدود 1280x1280, 1568x1056, 1056x1568, 1472x1088, 1088x1472, 1728x960, 960x1728 | القيمة الافتراضية1280x1280 |
الحقلuser_id | النوعstring | المتطلباختياري | القيم والحدود | القيمة الافتراضية— |
الحقلquality | النوعstring | المتطلباختياري | القيم والحدود hd, standard | القيمة الافتراضية— |
الحقلwatermark_enabled | النوعboolean | المتطلباختياري | القيم والحدود | القيمة الافتراضيةtrue |
الحقلstream | النوعboolean | المتطلباختياري | القيم والحدود false | القيمة الافتراضية— |
معلمات الطريقة ودورة حياتها
| المعلمة | المواصفات |
|---|---|
المعلمةcontent_type | المواصفاتapplication/json |
المعلمةrequired | المواصفاتmodel, prompt |
المعلمةoptional | المواصفاتsize, user_id, quality, watermark_enabled, stream |
المعلمةmaterial_types | المواصفاتtext |
المعلمةconditions | المواصفاتUse stream:false or omit stream. The complete buffered JSON result contains all generated images. |
دورة الحياة: synchronous_result_then_owned_library
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
الباقات
كيفية احتساب الرسوم النهائية
تقدّر التعرفات المعروضة التكلفة قبل التوليد. تُحسب الرسوم النهائية من التكلفة المسجّلة لعملية التوليد الأصلية. مدة المخرجات المقاسة والكميات المتوقعة ليست الكمية النهائية الخاضعة للفوترة.
مراجع التسعير لا تضيف خيارات للطلب. المعلمات المدعومة مذكورة للطريقة المحددة.
- الوضع السريع
- غير محدد عند اختيار الوضع السريع
- الوضع المرن
- غير محدد عند اختيار وضع flex
- أقصى جهد للاستدلال
- غير محدد عندما يُطبَّق الضبط الافتراضي default مع أقصى جهد للاستدلال
تعرفات تقديرية للمقارنة
الأسعار حسب الإعدادات
طابق كل رسم مع الشروط المعروضة. طبّق تعرفة واحدة لكل مجموعة من الإعدادات البديلة.
| الإعدادات | جدول التعرفة | الكمية المتوقعة | الرسوم |
|---|---|---|---|
| الإعداداتالتعرفات الأساسية للرموز | جدول التعرفةالتعرفة الأساسية | الكمية المتوقعة— | الرسوم الإدخال · رموز الإدخال · تقدير للمقارنة فقط — / 1K من الرموز الإخراج · رموز الإخراج · تقدير للمقارنة فقط — / 1K من الرموز الإدخال · قراءة ذاكرة التخزين المؤقت · تقدير للمقارنة فقط — / 1K من الرموز الإدخال · الكتابة إلى ذاكرة التخزين المؤقت · تقدير للمقارنة فقط — / 1K من الرموز الإدخال · الكتابة إلى ذاكرة التخزين المؤقت، 1 ساعة · تقدير للمقارنة فقط — / 1K من الرموز |
| الإعداداتEstimated generation cost | جدول التعرفة— | الكمية المتوقعةتقدير لتوليد واحد | الرسوم الإدخال · تكلفة التوليد التقديرية · تقدير للمقارنة فقط $0.09 تقدير قبل الإنشاء This estimate is not an additional charge or a fixed rate for the completed generation. |
تحجز Ailoot مبلغًا تقديريًا قبل الطلب. وبعد ظهور النتيجة، تُسوّي الرسوم النهائية بناءً على الاستخدام المقاس. وتستخدم تسوية البث سجل الاستخدام النهائي. كيفية عمل حجز المبلغ وتسوية الرسوم →
أمثلة للطلبات
Ailoot Ultra · Images
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
export AILOOT_API_KEY
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p=json.loads('{"model": "cogview-4", "prompt": "A calm studio product photograph with a plain background."}')
Path("request.json").write_text(json.dumps(p,ensure_ascii=False))
PY_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/images/generations \
-H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
--data-binary @request.json -D response-headers.txt -o result.json
# Submit once. Retain the complete result, original identifiers and every response header.
استلام النتائج وحفظها
Ailoot Ultra · Images
نزّل كل صورة مُرجعة أو احفظ محتواها بصيغة Base64
GET /v1/media/assetsGET /v1/media/assets/{asset_id}
الاحتفاظ بكل النتائج المكتملة
احفظ كل صورة مكتملة؛ نزّلها من كل URL مُرجع، أو فك ترميز محتواها بصيغة Base64.
Retain every returned image and field. Use owned content_url values and actual asset_id records; refresh the same asset when a link expires.
عند الحاجة إلى التحقق من الاستجابة الأصلية
Preserve the original response, headers and X-Client-Request-ID. An uncertain outcome does not authorize another creation.
الأسماء البديلة
الأسماء البديلة للنموذج
Ailoot Ultra cogview-4
الأسماء البديلة لمسارات الطرائق
استخدم مسارات الطرائق المعروضة أعلاه.
معرّفات النماذج ذات الصلة IDs
FAQ · Zhipu: CogView 4
- ما المدخلات والنتائج المتاحة؟
POST /v1/images/generations·cogview-4:text→image- ما الحقول التي يستخدمها الطلب؟
POST /v1/images/generations·cogview-4:model,prompt,size,user_id,quality,watermark_enabled,stream