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
• תיעוד ה-API של Muse Video
• הורדת OpenAPI
• Markdown להעתקה