MiniMax H3 Image

יצירה ועריכה של תמונות עם עד 16 תמונות ייחוס, מידות מדויקות, 1–10 תמונות פלט ותמחור לפי טוקנים.

דוגמה מהירה

שלח בקשת תמונה אחת, שמור את ה־id שהוחזר ובדוק את הסטטוס שוב ושוב עד שהמשימה תהיה completed או failed. ה־API הזה משתמש במשימות אסינכרוניות ובפלט באמצעות כתובות URL.

curl https://api.seedrouter.ai/v1/images/generations \
  -H "Authorization: Bearer $SEEDROUTER_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{"model":"minimax-h3-image","prompt":"An amber bottle on pale limestone in soft morning light","area":"1K","aspect_ratio":"3:2"}'

נקודת קצה וכותרות

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

כותרת	ערך
Authorization	`Bearer YOUR_API_KEY`
Content-Type	`application/json`

שמור את המפתח בשרת שלך. הצלחת HTTP מאשרת שהמשימה התקבלה; אין פירושה שהתמונה מוכנה.

יש 13 שדות נתמכים. רק model ו־prompt הם שדות חובה. השמט שדות אופציונליים כדי להשתמש בברירות המחדל; אף שדה אינו מקבל null. ה־Playground מספק מודל קבוע ועשרה שדות קלט הניתנים לעריכה. פורמט התגובה באמצעות URL ומסירת המשימות ללא הזרמה הם קבועים.

שדה	סוג	ברירת מחדל	מגבלה
`model`	מחרוזת	חובה	`minimax-h3-image`
`prompt`	מחרוזת	חובה	1–32,000 תווי Unicode לאחר הסרת תווי רווח לבן מההתחלה ומהסוף
`images`	מערך אובייקטים	מושמט	1–16 אובייקטים מסודרים, שכל אחד מהם מכיל `image_url`
`disable_prompt_enhanced`	בוליאני	`false`	ליצירה בלבד; ראה את התלויות בהמשך
`n`	מספר שלם	`1`	1–10
`size`	מחרוזת	`auto`	`auto` או `WIDTHxHEIGHT`; האות x קטנה
`aspect_ratio`	מחרוזת	`auto`	`auto` או `X:Y`; X ו־Y הם מספרים שלמים בטווח 1–300; יחס 1:3–3:1
`area`	מחרוזת	`4K`	`1K`, `2K`, `4K`; שטחי יעד מקורבים של 1,024², 2,048², 4,096² פיקסלים
`output_format`	מחרוזת	`jpeg`	`jpeg`, הכינוי החלופי `jpg`, `png`
`output_compression`	מספר שלם	`95`	0–100; איכות JPEG; אינו משפיע על PNG
`aigc_watermark`	בוליאני	`false`	הוספת סימן מים לתוכן שנוצר ב־AI
`response_format`	מחרוזת	`url`	רק `url`
`stream`	בוליאני	`false`	רק `false`; בדוק את הסטטוס באמצעות מזהה המשימה

תלויות גודל ופרומפט

size מפורש חייב להכיל מידות במספרים שלמים חיוביים, עם שטח שבין 655,360 ל־20,000,000 פיקסלים, כולל הגבולות. הרוחב חלקי הגובה חייב להיות בין 1/3 ל־3. לדוגמה, 2048x1152 הוא ערך תקין. כשמשתמשים במידות מפורשות, חובה להשמיט גם את aspect_ratio וגם את area, אפילו אם הערך שלהם היה auto.

כשהגודל מושמט או מוגדר כ־auto, השתמש ב־aspect_ratio וב־area יחד. השטח הוא גודל יעד; בדוק את הקובץ שנמסר כדי לדעת את המידות המדויקות. הוא אינו מחיר קבוע לתמונה בודדת.

הגדרת disable_prompt_enhanced: true מחייבת גודל מפורש בפיקסלים או יחס רוחב־גובה קבוע. כשהשיפור מושבת, המודל קורא בערך את 4,096 הטוקנים הראשונים של הפרומפט. מגבלת השליחה של 32,000 תווים עדיין חלה. בעריכה הפרומפטים תמיד משופרים, ולכן true נדחה כאשר images קיים.

לא מתקבלים שדות למסכה, seed, סגנון, איכות, פרומפט שלילי, רקע או רזולוציה נפרדת. פרמטרים לא מוכרים מחזירים שגיאה לפני השליחה. ה־API הזה אינו מציע הזרמה, תמונות base64 או פלט WebP.

תמונות ייחוס

השתמש בכתובות URL מסוג HTTP(S) הנגישות לציבור ואינן מכילות פרטי גישה מוטמעים. כל תמונה חייבת להיות JPEG, PNG, WebP, HEIC או HEIF; בגודל של עד 64 MiB; עם 128–8,192 פיקסלים בכל צלע; ויחס של עד 4 בין הצלע הארוכה לקצרה. שמור על גוף JSON בגודל של עד 64 MiB. ההפניה לקובצי התמונות נעשית באמצעות URL; הבתים שלהם אינם מוטמעים בגוף ה־JSON.

הקצה מטרה ברורה לכל תמונת ייחוס ותאר מה צריך להישאר ללא שינוי. סדר המערך מזהה את <Picture 1>, את <Picture 2> וכן הלאה.

{
  "model": "minimax-h3-image",
  "prompt": "Use <Picture 1> as the product and <Picture 2> as the setting. Preserve the product's shape and label. Match the setting's light and perspective.",
  "images": [
    {"image_url": "https://example.com/product.jpg"},
    {"image_url": "https://example.com/setting.jpg"}
  ],
  "aspect_ratio": "3:2",
  "area": "2K",
  "n": 1,
  "output_format": "png"
}

החלף את כתובות ה־URL לדוגמה בקובצי תמונה נגישים משלך.

חיוב

החיוב כולל שלוש קטגוריות טוקנים: קלט טקסט, קלט תמונה ופלט תמונה. הכפל את השימוש בפועל בכל קטגוריה בתעריף העדכני שלה. מספר תמונות הפלט, מידות התמונות ותמונות הייחוס משפיעים על השימוש; שמות הרזולוציות אינם קובעים סכום חיוב קבוע. בקשות שנכשלו אינן מחויבות. ראה תמחור עדכני.

תגובת משימה ובדיקת סטטוס

בקשה שהתקבלה מחזירה משימה אסינכרונית:

{"id":"task_example","model":"minimax-h3-image","status":"processing"}

curl https://api.seedrouter.ai/v1/tasks/task_example \
  -H "Authorization: Bearer $SEEDROUTER_API_KEY"

תגובה שהושלמה מכילה כתובות URL של תמונות ב־output.data. כל תמונה שנמסרה כוללת את ה־size שלה ועשויה לכלול revised_prompt (התיאור המשופר). output.created הוא זמן היצירה בשניות Unix, ו־output.output_format מזהה את הפורמט שנמסר. output.usage מציג את מספר הטוקנים של קלט הטקסט, קלט התמונה ופלט התמונה ואת מספר ה־generated_images שנמסרו. כתובות ה־URL והמזהים הבאים הם להמחשה:

{
  "id": "task_example",
  "model": "minimax-h3-image",
  "status": "completed",
  "output": {"data": [{"url": "https://file.deepytb.com/generated/example.jpg"}]}
}

בדוק את הסטטוס כל 10–20 שניות. חריגה מזמן ההמתנה בצד הלקוח אינה משימה שנכשלה: שמור את המזהה שלה והמשך לבדוק את הסטטוס במקום לשלוח בקשה כפולה. תגובות ציבוריות אינן מכילות יתרות חשבון או עלויות.

שגיאות

שגיאות HTTP משתמשות בפורמט {"error":{"code":integer,"message":string}}. למשימה שנכשלה יש status: "failed" ושגיאה. תקן פרמטרים לא תקינים לפני שליחה חדשה. ראה את מדריך השגיאות המשותף ואת מחזור חיי המשימה.