MiniMax H3 Image API
MiniMax-H3-Image הוא מודל של MiniMax ליצירת תמונות ברזולוציה של 4096×4096 פיקסלים ולעריכה עם עד 16 תמונות ייחוס, עם שליטה יצירתית חזקה וביצועים יעילים.
MiniMax-H3-Image הוא מודל של MiniMax ליצירת תמונות ועריכה שלהן. הוא מקבל טקסט ותמונות כקלט ומפיק תמונות, ומייצר פלט ברזולוציה של 4096 על 4096 פיקסלים (16 מגה-פיקסל) בעלות חישובית מעשית. המודל תומך ביצירת תמונה מטקסט וכן בעריכת תמונות מרובת תמונות ייחוס — עד 16 תמונות ייחוס — ומאפשר עריכות ממוקדות תוך שמירה על עקביות חלקים מהפריים. לפי התיעוד, הוא מציג את יכולת העמידה בהוראות החזקה ביותר מבין המודלים בקוד פתוח.
המודל מתאים למגוון משימות: פרסום ומיתוג, מסחר אלקטרוני, עיצוב מוצר, UI/UX, גיימינג, אמנות קונספט, חקר מוצרים ואיטרציות פריסה. הוא מצוין ליצירת תמונות עשירות בפרטים וריאליסטיות, ולשליטה יצירתית באמצעות תמונות ייחוס מרובות. ניתן להשתמש בו גם לעריכות ממוקדות שבהן יש לשמור על מראה עקבי של חלקים מהתמונה.
המודל מופץ תחת הסכם רישיון MiniMax-H3-Image Community License Agreement. קיימת גרסה מקומית בשם MiniMax-H3-Image-PE הניתנת להרצה עם שרת SGLang מקומי. יש לשים לב למגבלות: אין תמיכה בפרומפטים שליליים והם נדחים; ערכי num_inference_steps ו-guidance_scale שאינם הערכים הקבועים מחזירים שגיאת HTTP 400; הפרומפט נחתך ל-4096 טוקנים. כמו כן, שימוש מסחרי הדורש אישור בכתב בנפרד יש לבקש דרך platform.minimax.io/license. להגדרות: min_generation_area נע בין 1024 ל-16777216 פיקסלים, ברירת מחדל 4194304 (2048 על 2048); גדלים קטנים יותר נוצרים על קנבס גדול יותר באותו יחס גובה-רוחב ומשונים באינטרפולציית LANCZOS; מומלץ להגדיר את התקן המחולל ל-CPU לשם שחזור seed; יש להגדיר response_format ל-b64_json.
עודכן:
MODEL ID
minimax-h3-image- קלט
- text / image
- פלט
- image
עיקרי הדברים
- פלט ברזולוציה של 4096×4096 פיקסלים
- עריכה עם עד 16 תמונות ייחוס
- עמידה בהוראות החזקה ביותר בקוד פתוח
- שליטה יצירתית באמצעות תמונות ייחוס
- הגדרות הסקה קבועות ויעילות
ספקים
השוו מחירי API בין ספקים. בחרו ספק כדי לראות את כל החיובים והתנאים.
| זמינות | |
|---|---|
נתונים היסטוריים אינם בדיקת מצב בזמן אמת. נתונים חסרים אינם מצביעים על השבתה.
התחלה מהירה
שלחו משימת תמונה, בדקו את מצבה ושמרו את התמונות. הדוגמאות משתמשות ב-curl ובספרייה התקנית של Python 3.
POST https://openapi.felo.ai/api/v1/images/generations
1קבלו את מפתח ה-API שלכם
צרו מפתח בחשבון Felo API Platform שלכם והגדירו אותו כמשתנה סביבה.
export FELO_API_KEY="YOUR_API_KEY"2שלחו את הבקשה הראשונה
ערכים אופציונליים משתנים לפי המודל ואינם מוגדרים כאן. בדקו אותם ב-Playground. השדות נמצאים לצד model ו-prompt, ללא עטיפת input.
curl --fail-with-body --max-time 60 "https://openapi.felo.ai/api/v1/images/generations" \
-H "Authorization: Bearer $FELO_API_KEY" \
-H "Content-Type: application/json" \
-o created.json \
-d '{
"prompt": "A studio product photo of a ceramic coffee cup on warm linen, soft morning light",
"model": "minimax-h3-image"
}'3בדיקת המשימה
השליחה מחזירה task_id. בדקו כל 3 שניות במצב queued או running; עצרו ב-succeeded, failed או interrupted. ההמתנה מוגבלת ל-30 דקות. שמרו created.json כדי להמשיך לבדוק בלי לשלוח שוב.
python3 - <<'PY'
import json, os, time
from pathlib import Path
from urllib.parse import quote
from urllib.request import Request, urlopen
task = json.loads(Path("created.json").read_text())
task_id = task["task_id"]
url = "https://openapi.felo.ai/api/v1/images/generations/" + quote(task_id, safe="")
headers = {"Authorization": "Bearer " + os.environ["FELO_API_KEY"]}
deadline = time.monotonic() + 1800
while task["status"] in ("queued", "running"):
if time.monotonic() >= deadline:
raise TimeoutError(f"Keep task_id={task_id} to resume polling")
time.sleep(3)
with urlopen(Request(url, headers=headers), timeout=60) as response:
task = json.load(response)
if task.get("task_id") != task_id or task.get("kind") != "image":
raise ValueError("Unexpected task response")
print(task["status"])
if task["status"] != "succeeded":
raise RuntimeError(task.get("error") or task["status"])
if not task.get("outputs"):
raise ValueError("Task succeeded without image outputs")
Path("task.json").write_text(json.dumps(task))
print("Saved task.json")
PY4הורדת הפלט
לאחר הצלחה, שמרו outputs מתוך task.json. נתמכים קישורי HTTPS, אובייקטי URL ו-b64_json. הורידו קישורים חתומים בהקדם; להורדת תמונות אין צורך במפתח API.
python3 - <<'PY'
import base64, json
from pathlib import Path
from urllib.request import urlopen
task = json.loads(Path("task.json").read_text())
if task.get("status") != "succeeded" or not task.get("outputs"):
raise ValueError("No completed image outputs")
extensions = {"image/png": ".png", "image/jpeg": ".jpg", "image/webp": ".webp", "image/gif": ".gif", "image/avif": ".avif"}
for index, output in enumerate(task["outputs"], 1):
item = output if isinstance(output, dict) else {}
url = output if isinstance(output, str) else item.get("url") or item.get("unsigned_url")
mime = item.get("media_type") or "image/png"
if url and url.startswith("https://"):
with urlopen(url, timeout=60) as response:
data = response.read()
mime = response.headers.get_content_type()
elif url and url.startswith("data:image/") and ";base64," in url:
header, encoded = url.split(",", 1)
mime = header[5:].split(";", 1)[0]
data = base64.b64decode(encoded, validate=True)
elif item.get("b64_json"):
data = base64.b64decode(item["b64_json"], validate=True)
else:
raise ValueError("Unrecognized image output")
path = Path(f"image-{index}" + extensions.get(mime, ".bin"))
path.write_bytes(data)
print(path)
PYinput_references
לעריכת תמונה, החליפו את כתובת הדוגמה בכתובת HTTPS שלכם או ב-data URL של תמונת base64. שלחו פעם אחת והמשיכו באותם שלבי בדיקה ושמירה.
curl --fail-with-body --max-time 60 "https://openapi.felo.ai/api/v1/images/generations" \
-H "Authorization: Bearer $FELO_API_KEY" \
-H "Content-Type: application/json" \
-o created.json \
-d '{
"prompt": "Keep the product and framing. Replace the background with a sunlit marble countertop.",
"model": "minimax-h3-image",
"input_references": [
{
"type": "image_url",
"image_url": {
"url": "https://example.com/product.png"
}
}
]
}'פרמטרים נתמכים
- n
- size
- resolution
- aspect_ratio
- output_format
- input_references
מעדיפים את העיון המלא?
מסמכי API →שאלות נפוצות
מהו MiniMax H3 Image?
MiniMax-H3-Image הוא מודל של MiniMax ליצירת תמונות ועריכה שלהן. הוא מקבל טקסט ותמונות כקלט ומפיק תמונות, ומייצר פלט ברזולוציה של 4096 על 4096 פיקסלים (16 מגה-פיקסל) בעלות חישובית מעשית. המודל תומך ביצירת תמונה מטקסט וכן בעריכת תמונות מרובת תמונות ייחוס — עד 16 תמונות ייחוס — ומאפשר עריכות ממוקדות תוך שמירה על עקביות חלקים מהפריים. לפי התיעוד, הוא מציג את יכולת העמידה בהוראות החזקה ביותר מבין המודלים בקוד פתוח. המודל מתאים למגוון משימות: פרסום ומיתוג, מסחר אלקטרוני, עיצוב מוצר, UI/UX, גיימינג, אמנות קונספט, חקר מוצרים ואיטרציות פריסה. הוא מצוין ליצירת תמונות עשירות בפרטים וריאליסטיות, ולשליטה יצירתית באמצעות תמונות ייחוס מרובות. ניתן להשתמש בו גם לעריכות ממוקדות שבהן יש לשמור על מראה עקבי של חלקים מהתמונה. המודל מופץ תחת הסכם רישיון MiniMax-H3-Image Community License Agreement. קיימת גרסה מקומית בשם MiniMax-H3-Image-PE הניתנת להרצה עם שרת SGLang מקומי. יש לשים לב למגבלות: אין תמיכה בפרומפטים שליליים והם נדחים; ערכי num_inference_steps ו-guidance_scale שאינם הערכים הקבועים מחזירים שגיאת HTTP 400; הפרומפט נחתך ל-4096 טוקנים. כמו כן, שימוש מסחרי הדורש אישור בכתב בנפרד יש לבקש דרך platform.minimax.io/license. להגדרות: min_generation_area נע בין 1024 ל-16777216 פיקסלים, ברירת מחדל 4194304 (2048 על 2048); גדלים קטנים יותר נוצרים על קנבס גדול יותר באותו יחס גובה-רוחב ומשונים באינטרפולציית LANCZOS; מומלץ להגדיר את התקן המחולל ל-CPU לשם שחזור seed; יש להגדיר response_format ל-b64_json.
איך מחייבים על השימוש?
החיוב שלכם תלוי בספק שאתם משתמשים בו, במחירים שלו ובשימוש שלכם. קלט ארוך יותר או תנאים אחרים עשויים להיות במחיר שונה. החיוב מבוסס על עלות היצירה בפועל. ראו את החשבונית לסכום הסופי.
אילו סוגי קלט המודל תומך בהם?
המודל תומך בקלט טקסט ובקלט תמונות, ומפיק תמונות כפלט. ניתן להשתמש בו ליצירת תמונה מטקסט ולעריכת תמונות עם עד 16 תמונות ייחוס.
מהי רזולוציית הפלט המקסימלית?
המודל מייצר תמונות ברזולוציה של 4096 על 4096 פיקסלים, כלומר 16 מגה-פיקסל.
האם יש מגבלות על אורך הפרומפט?
הפרומפט נחתך ל-4096 טוקנים. כמו כן, אין תמיכה בפרומפטים שליליים והם נדחים.
האם ניתן לשנות את פרמטרי ההסקה?
לא. הגדרות ההסקה קבועות: num_inference_steps 6 ו-guidance_scale 1. ערכים אחרים מחזירים שגיאת HTTP 400.
מה ההבדל בין MiniMax-H3-Image ל-MiniMax-H3-Image-PE?
MiniMax-H3-Image-PE היא גרסה הניתנת לפריסה מקומית והרצה עם שרת SGLang מקומי, בעוד שהמודל הראשי מיועד לשימוש רגיל.
האם יש דרישות מיוחדות לשימוש מסחרי?
שימוש מסחרי הדורש אישור בכתב בנפרד יש לבקש דרך platform.minimax.io/license. המודל מופץ תחת MiniMax-H3-Image Community License Agreement.