Muse Image

⁦Muse Image⁩ هو نموذج الصور من ⁦Meta Superintelligence Labs⁩. ينتج الطلب الواحد صورة واحدة من موجّه، أو من موجّه مع ما يصل إلى 9 صور مرجعية، بإحدى سبع نسب للعرض إلى الارتفاع. أرسل الطلب، واحتفظ بمعرّف المهمة المُعاد، واقرأ الصورة المكتملة من المهمة. تُرسل الصور المرجعية كروابط URL.

معرّفات النماذج

راجع صفحة النموذج للاطلاع على الأسعار الحالية.

مثال سريع

curl https://api.seedrouter.ai/v1/images/generations \
  -H "Authorization: Bearer $SEEDROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "muse-image",
    "prompt": "A red ceramic mug on a white table, soft studio light, product photography. No text, no logos.",
    "aspect_ratio": "1:1"
  }'

نقطة النهاية

POST https://api.seedrouter.ai/v1/images/generations

الاستجابة مهمة ({"id": "task_...", "status": "processing"}) لا الصورة المكتملة. استعلم GET /v1/tasks/{task_id} للحصول على النتيجة. واحتفظ بمفاتيح API في شفرة تعمل على الخادم. تُرسل الصور المرجعية في الطلب نفسه عبر image_urls؛ ولا يُستخدم /v1/images/edits لهذا النموذج.

المعاملات

تُحذف الحقول غير المدرجة في هذه القائمة قبل تمرير الطلب؛ ولا تسبّب خطأ مطلقًا ولا تغيّر المخرجات. لا توجد إعدادات للدقة أو البذرة أو الموجّه السلبي أو القناع أو صيغة المخرجات. وcallback_url غير متاح؛ استعلم عن المهمة بدلًا منه.

الصور المرجعية

مرّر حتى 9 صور في image_urls وحدّد في prompt ما يجب الحفاظ عليه وما يجب تغييره. يستخدمها ⁦Muse Image⁩ كصور مرجعية لصورة جديدة؛ وعند حذف aspect_ratio، تتبع النتيجة شكلها.

{
  "model": "muse-image",
  "prompt": "Keep this exact jacket; show it folded in a flat lay of hiking gear on pine boards, soft morning light.",
  "image_urls": ["https://example.com/jacket.png"],
  "aspect_ratio": "9:16"
}

مدخلات الوسائط

كل صورة مرجعية رابط ⁦HTTP(S)⁩ عام. ولا تُقبل روابط data URI بصيغة base64: ارفع الملف إلى تخزينك الخاص ومرّر رابطه. استخدم صور PNG أو JPEG أو WebP؛ يجب ألا يتجاوز مجموع أحجام الملفات الأصلية لجميع الصور المرجعية 11 MB. تفشل مجموعة الصور التي تتجاوز هذا الحد بعد قبولها ولا تُحتسب.

عوامل التكلفة

راجع قسم أسعار النموذج للاطلاع على الأسعار الحالية. لدى ⁦Muse Image⁩ سعر واحد لكل صورة:

cost = price per image × 1

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

بنية المخرجات

يعيد الإرسال المهمة:

{"id": "task_...", "model": "muse-image", "status": "processing", "created_at": 1789689600}

جلب المهمة

GET https://api.seedrouter.ai/v1/tasks/{task_id}

استعلم كل 10–20 ثانية حتى تصبح status بقيمة completed أو failed. انتهاء مهلة الشبكة أثناء الاستعلام لا يعني فشل التوليد: احتفظ بمعرّف المهمة وتابع التحقق منها. ولا تنشئ مهمة أخرى للتحقق من التقدّم.

المهمة المكتملة

{
  "id": "task_...",
  "model": "muse-image",
  "status": "completed",
  "created_at": 1789689600,
  "finished_at": 1789689680,
  "output": {
    "created": 0,
    "data": [
      { "url": "https://static.seedrouter.ai/media/tasks/task_example/0.webp" }
    ]
  }
}

تُسلَّم الصورة بصيغة WebP، وهي صيغة النموذج نفسه؛ ولا يوجد إعداد لصيغة المخرجات. يحدّد النموذج أبعاد البكسل. في اختباراتنا، عاد الطلب النصي فقط بأبعاد ⁦1600 × 1600⁩، ونسبة 16:9 بأبعاد ⁦2048 × 1152⁩، و3:4 بأبعاد ⁦1344 × 1792⁩، و9:16 بأبعاد ⁦1152 × 2048⁩، بعد نحو 50–180 ثانية من الإرسال.

الأخطاء

الطلبات المرفوضة قبل إنشاء المهمة تعيد خطأ HTTP مع كائن error ولا تُحتسب. أما المهمة التي تفشل بعد قبولها فتعيد HTTP 200 عند الاستعلام عنها، مع status: "failed" وكائن error.

راجع فهرس الأخطاء المشترك للاطلاع على الرموز وحالات HTTP وإرشادات إعادة المحاولة.

{
  "id": "task_...",
  "model": "muse-image",
  "status": "failed",
  "error": {
    "code": 60001,
    "message": "The request was rejected by the content policy. Please revise the prompt or input images."
  }
}

إذا انتهت مهلة الإرسال نفسه، فراجع مهامك قبل الإرسال مجددًا: فربما قُبل الطلب الأول.

نصائح

• حدّد الموضوع والمكان والإضاءة والتأطير؛ يلتزم ⁦Muse Image⁩ بوصف محدّد بدقة.
• مع الصور المرجعية، حدّد بدقة ما يجب أن يبقى كما هو، مثل لون المنتج أو شكله.
• احذف aspect_ratio لمطابقة شكل الصورة المرجعية؛ واضبطه للقص بما يناسب قناة النشر.
• أضف no text, no logos لإبعاد العلامات المختلقة.

مواضيع ذات صلة

• Playground وأسعار Muse Image
• مرجع Muse Video API
• تنزيل OpenAPI
• Markdown قابل للنسخ