Felo API PlatformFelo API Platform
חזרה למודלים

MiniMax H3 Image Highspeed API

MiniMax H3 Image Highspeed הוא מודל גנרטיבי רב-מודלי בקוד פתוח מבית MiniMax ליצירת ועריכת תמונות מטקסט ומתמונות, עם מצב מהירות מואץ עד פי 3–4 מהגרסה הרגילה.

MiniMax H3 Image Highspeed הוא וריאציה מהירה של MiniMax H3 Image, חלק ממשפחת MiniMax H3 – מערכת גנרטיבית רב-מודלית כללית התומכת בטקסט, תמונות, וידאו ואודיו. המודל מקבל קלט טקסט וקלט תמונות ומייצר תמונות, ומאפשר יצירה מאפס כמו גם עריכה של תמונות קיימות. ניתן לשלב עד 16 תמונות ייחוס ביצירה אחת, מה שמסייע בשמירה על עקביות דמויות ובניית סצנות מרובות רכיבים. המודל מסוגל לקרוא הנחיות ארוכות ולעבד טקסט צפוף וארוך בתוך התמונה, כולל פריסות טקסט מורכבות.

המודל מיועד למגוון משימות: יצירת תמונות מטקסט, עריכת תמונות, פוסטרים, אינפוגרפיקות, מסכי ממשק משתמש, חומרי שיווק, אב-טיפוס מהיר, עיבוד באצווה, קומפוזיציות מורכבות ויצירת סצנות מרובות אלמנטים. מצב Highspeed מהיר פי 3 עד 4 ממצב הסטנדרטי, בעוד שמצב סטנדרטי מהיר פי 1.5 עד 2 ממודלים מתחרים מסוימים. המודל מייצר תמונות ברזולוציה מקורית של כ-16 מגה-פיקסל ותומך ביחסי גובה-רוחב שבין 1:3 ל-3:1. הוא מקבל פרמטרים ומגבלות זהים לאלה של הגרסה הסטנדרטית.

המודל שוחרר במשקולות פתוחות ויכול לרוץ מקומית על חומרה צנועה. עם זאת, יחס דחיסה מרחבי אפקטיבי של פי 32 עלול לגרום לטשטוש ניכר ברזולוציות מסוימות, ולעתים קרובות חסר פרטים עדינים. כמו כן, המודל כבד יחסית בשל מקודד טקסט בנפח 32b. משתמשים דיווחו על יצירת תמונות בגודל 5 עד 10 מגה-פיקסל עם 16 ג'יגה-בייט של זיכרון VRAM, ועל רזולוציה של מעל 2 מגה-פיקסל עם יותר מ-20 שלבים על 6 ג'יגה-בייט VRAM ו-16 ג'יגה-בייט RAM.

עודכן:

MODEL ID

minimax-h3-image-highspeed
קלט
text / image
פלט
image

עיקרי הדברים

  • מהיר פי 3–4 ממצב סטנדרטי
  • תמיכה בעד 16 תמונות ייחוס
  • רזולוציה מקורית של כ-16 מגה-פיקסל
  • יחסי גובה-רוחב מ-1:3 עד 3:1
  • מודל בקוד פתוח להרצה מקומית
  • קורא הנחיות ארוכות ומרנדר טקסט צפוף

ספקים

1 ספקים

השוו מחירי 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-highspeed"
}'

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")
PY

4הורדת הפלט

לאחר הצלחה, שמרו 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)
PY
input_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-highspeed",
  "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 Highspeed?

MiniMax H3 Image Highspeed הוא וריאציה מהירה של MiniMax H3 Image, חלק ממשפחת MiniMax H3 – מערכת גנרטיבית רב-מודלית כללית התומכת בטקסט, תמונות, וידאו ואודיו. המודל מקבל קלט טקסט וקלט תמונות ומייצר תמונות, ומאפשר יצירה מאפס כמו גם עריכה של תמונות קיימות. ניתן לשלב עד 16 תמונות ייחוס ביצירה אחת, מה שמסייע בשמירה על עקביות דמויות ובניית סצנות מרובות רכיבים. המודל מסוגל לקרוא הנחיות ארוכות ולעבד טקסט צפוף וארוך בתוך התמונה, כולל פריסות טקסט מורכבות. המודל מיועד למגוון משימות: יצירת תמונות מטקסט, עריכת תמונות, פוסטרים, אינפוגרפיקות, מסכי ממשק משתמש, חומרי שיווק, אב-טיפוס מהיר, עיבוד באצווה, קומפוזיציות מורכבות ויצירת סצנות מרובות אלמנטים. מצב Highspeed מהיר פי 3 עד 4 ממצב הסטנדרטי, בעוד שמצב סטנדרטי מהיר פי 1.5 עד 2 ממודלים מתחרים מסוימים. המודל מייצר תמונות ברזולוציה מקורית של כ-16 מגה-פיקסל ותומך ביחסי גובה-רוחב שבין 1:3 ל-3:1. הוא מקבל פרמטרים ומגבלות זהים לאלה של הגרסה הסטנדרטית. המודל שוחרר במשקולות פתוחות ויכול לרוץ מקומית על חומרה צנועה. עם זאת, יחס דחיסה מרחבי אפקטיבי של פי 32 עלול לגרום לטשטוש ניכר ברזולוציות מסוימות, ולעתים קרובות חסר פרטים עדינים. כמו כן, המודל כבד יחסית בשל מקודד טקסט בנפח 32b. משתמשים דיווחו על יצירת תמונות בגודל 5 עד 10 מגה-פיקסל עם 16 ג'יגה-בייט של זיכרון VRAM, ועל רזולוציה של מעל 2 מגה-פיקסל עם יותר מ-20 שלבים על 6 ג'יגה-בייט VRAM ו-16 ג'יגה-בייט RAM.

איך מחייבים על השימוש?

החיוב שלכם תלוי בספק שאתם משתמשים בו, במחירים שלו ובשימוש שלכם. קלט ארוך יותר או תנאים אחרים עשויים להיות במחיר שונה. החיוב מבוסס על עלות היצירה בפועל. ראו את החשבונית לסכום הסופי.

אילו סוגי קלט המודל תומך בהם?

המודל מקבל קלט טקסט וקלט תמונות, ומייצר תמונות כפלט. הוא תומך גם ביצירה מטקסט וגם בעריכה של תמונות קיימות.

כמה תמונות ייחוס ניתן לשלב ביצירה אחת?

ניתן לשלב עד 16 תמונות ייחוס ביצירה אחת, מה שמאפשר שמירה על עקביות דמויות ובניית סצנות מרובות רכיבים.

מהי הרזולוציה המקסימלית ויחסי הגובה-רוחב הנתמכים?

המודל מייצר תמונות ברזולוציה מקורית של כ-16 מגה-פיקסל ותומך ביחסי גובה-רוחב שבין 1:3 ל-3:1.

מה ההבדל בין מצב Highspeed למצב הסטנדרטי?

מצב Highspeed מהיר פי 3 עד 4 ממצב הסטנדרטי, אך מקבל פרמטרים ומגבלות זהים לאלה של הגרסה הסטנדרטית.

האם המודל יכול לרוץ מקומית?

כן, מדובר במודל בקוד פתוח שיכול לרוץ מקומית על חומרה צנועה. משתמשים דיווחו על יצירת תמונות בגודל 5 עד 10 מגה-פיקסל עם 16 ג'יגה-בייט VRAM.

למה המודל עלול להפיק תמונות מטושטשות?

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

מודלים קשורים