Meta: Muse Image
ينشئ Muse Image الصور ويعدّلها انطلاقًا من النص والمراجع البصرية. استخدم meta/muse-image مع طريقة Images لوصف تكوين جديد أو توجيه تعديل بصورة موجودة. ويعيد صورًا ناتجة في استجابة كاملة، دون إدراج بث أصلي للصور لهذا الملف.
عن النموذج
يغطي هذا الوصف قدرات النموذج. وترد أدناه المدخلات والمخرجات والخيارات المتاحة في Ailoot للطريقة المحددة.
Muse Image نموذج Meta لتوليد الصور، ويُختار بالمعرّف الدقيق meta/muse-image. مدخلاته الموثّقة هي النص والصور، ومخرجه صورة. استخدم طريقة Images في POST /v1/images/generations لإعداد موجز مكتوب لصورة جديدة أو مراجعة موجّهة بمرجع. ينبغي أن يذكر prompt ما المطلوب إنشاؤه وأي علاقة بصرية تهم النتيجة.
لتكوين جديد، صِف الموضوع والبيئة والإضاءة ولوحة الألوان وزاوية الرؤية. اشرح موضع الاستخدام عندما يؤثر في التصميم، مثل غلاف أفقي يكون فيه الموضوع بعيدًا عن مساحة النص. قد يطلب موجز مشهد وعاءً زجاجيًا على حافة حجرية، وزاوية رؤية منخفضة، وضوء صباح باردًا، وخلفية هادئة. تمنحك التعليمات البصرية المحددة تفاصيل ملموسة لمقارنتها بالصورة المكتملة.
للمراجعة، قدّم الصورة ذات الصلة عبر input_references وحدّد التغيير المطلوب. يقبل تمثيل المرجع الموثّق URL لصورة عبر HTTP(S) أو عنوان base64 data URL. اشرح تفاصيل المصدر التي ينبغي الحفاظ عليها في المراجعة، مثل شكل الموضوع أو التأطير أو المعالجة اللونية العامة، وصِف العنصر الذي ينبغي تغييره. احتفظ بالمصدر والمراجعة معًا عند تقرير مدى ملاءمة النتيجة للمهمة.
يسرد ملف النموذج المخصص مدخلًا من نص وصورة، ومخرجًا من صورة، وعدم وجود بث أصلي. استخدم استجابة الصورة الكاملة بوصفها النتيجة. احتفظ بكل صورة في مصفوفة data المكتملة. ولمخرج b64_json، فك ترميز بايتات الصورة؛ ولعنوان URL صورة مُعاد، استرجع ملف الصورة الفعلي. استخدم media_type المُعاد عند توفره، واحتفظ بمعلومات الاستجابة وusage المصاحبة.
احتفظ بالتهيئة المختارة مع الموجز البصري. بعد الاكتمال، افحص تفاصيل الموضوع والتكوين والعلاقة بالمرجع وأي كتابة بمقارنتها بالموجز. احتفظ بالمخرج المختار والمراجع المصدرية وprompt كي تبدأ أي مراجعة لاحقة من صورة معلومة وتغيير صريح.
Ailoot Ultra · Images POST /v1/images/generations meta/muse-image
meta/muse-imageالبداية
ينشئ Muse Image الصور ويعدّلها انطلاقًا من النص والمراجع البصرية. استخدم meta/muse-image مع طريقة Images لوصف تكوين جديد أو توجيه تعديل بصورة موجودة. ويعيد صورًا ناتجة في استجابة كاملة، دون إدراج بث أصلي للصور لهذا الملف.
- المدخلات المقبولة
- النص · الصور
- النتائج
- الصور
متاح في Ailoot · المدخلات والطرائق
Ailoot Ultra · Images POST /v1/images/generations
- الإدخال
text,image- الإخراج
image- صيغة الإخراج
- ملف صورة
| الحقل | النوع | المتطلب | القيم والحدود | القيمة الافتراضية |
|---|---|---|---|---|
الحقلmodel | النوعstring | المتطلبمطلوب | القيم والحدود meta/muse-image | القيمة الافتراضية— |
الحقلprompt | النوعstring | المتطلبمطلوب | القيم والحدود | القيمة الافتراضية— |
الحقلstream | النوعboolean | المتطلباختياري | القيم والحدود false | القيمة الافتراضيةfalse |
الحقلinput_references | النوعarray | المتطلباختياري | القيم والحدود | القيمة الافتراضية— |
معلمات الطريقة ودورة حياتها
| المعلمة | المواصفات |
|---|---|
المعلمةcontent_type | المواصفاتapplication/json |
المعلمةrequired | المواصفاتmodel, prompt |
المعلمةoptional | المواصفاتstream, input_references |
المعلمةmaterial_types | المواصفاتtext, image |
المعلمة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.98304 تقدير قبل الإنشاء 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": "meta/muse-image", "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 meta/muse-image
الأسماء البديلة لمسارات الطرائق
استخدم مسارات الطرائق المعروضة أعلاه.
معرّفات النماذج ذات الصلة IDs
FAQ · Meta: Muse Image
- ما المدخلات والنتائج المتاحة؟
POST /v1/images/generations·meta/muse-image:text,image→image- ما الحقول التي يستخدمها الطلب؟
POST /v1/images/generations·meta/muse-image:model,prompt,stream,input_references