Meta: Muse Image
Muse Image יוצר ועורך תמונות מטקסט ומתמונות ייחוס. השתמשו ב-meta/muse-image עם מתודת Images כדי לתאר קומפוזיציה חדשה או להנחות שינוי בעזרת תמונה קיימת. הוא מחזיר פלטי תמונה בתגובה מלאה, ללא הזרמת תמונות מובנית הרשומה לפרופיל הזה.
על המודל
התיאור הזה מציג את יכולות המודל. הקלט, הפלט והאפשרויות הזמינים ב-Ailoot מפורטים בהמשך לפי השיטה שנבחרה.
Muse Image הוא מודל יצירת התמונות של Meta, שנבחר באמצעות המזהה המדויק meta/muse-image. הקלטים המתועדים שלו הם טקסט ותמונות, והפלט שלו הוא תמונה. השתמשו במתודת Images ב-POST /v1/images/generations כדי להכין תיאור כתוב לתוצר חזותי חדש או לתיקון מונחה תמונת ייחוס. ה-prompt צריך לציין מה ליצור ואיזה יחס חזותי חשוב לתוצאה.
לקומפוזיציה חדשה, תארו את הנושא, הסביבה, התאורה, פלטת הצבעים ונקודת המבט. הסבירו את יעד השימוש כאשר הוא משפיע על העיצוב, כגון תמונת שער לרוחב שהנושא בה ממוקם הרחק מאזור טקסט. תיאור סצנה יכול לבקש כלי זכוכית על מדף אבן, נקודת מבט נמוכה, אור בוקר קריר ורקע מאופק. הוראות חזותיות ספציפיות נותנות פרטים קונקרטיים שאפשר להשוות לתמונה שהושלמה.
לתיקון, ספקו את התמונה הרלוונטית דרך input_references והגדירו את השינוי הרצוי. הייצוג המתועד של תמונת הייחוס מקבל כתובת HTTP(S) לתמונה או כתובת נתונים מסוג base64. הסבירו אילו פרטי מקור צריכים להישמר בתיקון, כגון צורת הנושא, המסגור או טיפול הצבע הכולל, ותארו את הרכיב שצריך להשתנות. שמרו את המקור והתיקון יחד כאשר מחליטים אם התוצאה מתאימה למשימה.
פרופיל המודל הייעודי מפרט קלט טקסט ותמונה, פלט תמונה וללא הזרמה מובנית. השתמשו בתגובת התמונה המלאה כתוצאה. שמרו כל תמונה במערך data שהושלם. לפלט b64_json, פענחו את בתי התמונה; לכתובת URL לתמונה שהוחזרה, שלפו את קובץ התמונה בפועל. השתמשו ב-media_type שהוחזר כאשר הוא זמין, ושמרו את התגובה ואת פרטי השימוש הנלווים.
שמרו את התצורה שנבחרה עם התיאור החזותי. לאחר ההשלמה, בדקו את פרטי הנושא, הקומפוזיציה, הקשר לתמונת הייחוס וכל כיתוב מול התיאור. שמרו את הפלט הנבחר, תמונות המקור וה-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
- לא צוין כאשר נבחר מצב 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