Hailuo 2.3 Fast
MiniMax Hailuo 2.3 Fast מנפיש תמונת פריים ראשון באמצעות הנחיית תנועה קצרה. בחרו בפרופיל הזה ליצירת וידאו מתמונה עבור שוט של מוצר, תנוחת דמות או תמונת סטילס מלוח סיפור.
על המודל
התיאור הזה מציג את יכולות המודל. הקלט, הפלט והאפשרויות הזמינים ב-Ailoot מפורטים בהמשך לפי השיטה שנבחרה.
MiniMax Hailuo 2.3 Fast הוא פרופיל Fast המוגדר ליצירת וידאו מתמונה. התחילו בתמונת פריים ראשון עם קומפוזיציה מוכנה ותארו כיצד הנושא או המצלמה צריכים לנוע. תמונת מוצר, תנוחת דמות או פריים מלוח סיפור מעניקים לשוט נקודת פתיחה חזותית מוחשית.
הכינו את התמונה ואת בריף התנועה
ספקו תמונת PNG או JPEG ריבועית באמצעות כתובת HTTPS, עם כל צלע בין 300 ל־4,096 פיקסלים. קובץ התמונה שיורד חייב להיות בגודל שאינו עולה על 20,000,000 בתים. שמרו על הנחיה באורך שבין 1 ל־199 תווים, הממוקדת בפעולה גלויה אחת ובתנועה החשובה לשוט.
עקבו אחר הקליפ עד להשלמתו
הפרופיל הזה מוגדר לקליפ MP4 אחד בגודל 768 × 768 ובמשך נומינלי של שש שניות. שלחו את הבקשה פעם אחת, שמרו את המזהה שהוחזר ועקבו אחר אותה בקשה מקורית עד להשלמתה. הורידו את הווידאו שהוחזר ושמרו עם התוצאה את הממדים שעליהם דווח ואת המשך שנמדד. אם תוצאת היצירה אינה ודאית, המשיכו לבדוק את הבקשה המקורית במקום ליצור אותה מחדש.
Ailoot Ultra · וידאו POST /v1/videos MiniMax-Hailuo-2.3-Fast
MiniMax-Hailuo-2.3-Fastהתחלה
MiniMax Hailuo 2.3 Fast מנפיש תמונת פריים ראשון באמצעות הנחיית תנועה קצרה. בחרו בפרופיל הזה ליצירת וידאו מתמונה עבור שוט של מוצר, תנוחת דמות או תמונת סטילס מלוח סיפור.
- סוגי קלט נתמכים
- טקסט · תמונות
- תוצאות
- וידאו
זמין ב-Ailoot · קלט ושיטות
Ailoot Ultra · וידאו POST /v1/videos
- סוגי קלט
text,image- סוגי פלט
video- פורמט פלט
- mp4
- מספר פלטים
- עד 1 פלט
| שדה | סוג | דרישה | ערכים ומגבלות | ברירת מחדל |
|---|---|---|---|---|
שדהmodel | סוגstring | דרישהחובה | ערכים ומגבלות MiniMax-Hailuo-2.3-Fast | ברירת מחדל— |
שדהprompt | סוגstring | דרישהחובה | ערכים ומגבלות אורך מזערי: 1 אורך מרבי: 199 יחידה: תווי Unicode | ברירת מחדל— |
שדהduration | סוגinteger | דרישהחובה | ערכים ומגבלות 6 יחידה: שניות | ברירת מחדל— |
שדהresolution | סוגstring | דרישהחובה | ערכים ומגבלות 768P | ברירת מחדל— |
שדהfirst_frame_image | סוגhttps_url | דרישהחובה | ערכים ומגבלות גודל קובץ מרבי בבייטים: 20,000,000 סוגי MIME: image/png, image/jpeg מידה מזערית: 300 מידה מרבית: 4,096 ריבוע בלבד: כן | ברירת מחדל— |
שילובים של חומרי קלט
מתמונה לווידאו · נדרש: prompt, first_frame_image
פרמטרים ומחזור חיים של השיטה
| פרמטר | מפרט |
|---|---|
פרמטרcontent_type | מפרטapplication/json |
פרמטרrequired | מפרטmodel, prompt, duration, resolution, first_frame_image |
פרמטרother_options | מפרטfalse |
פרמטרduration | מפרט6 |
פרמטרresolution | מפרט768P |
פרמטרprompt_max_characters | מפרט199 |
פרמטרfirst_frame_image | מפרט{"type":"https_url","format":["png","jpeg"],"dimensions":"ריבוע בגודל 300..4096 פיקסלים","full_image_validation_before_send":true,"maximum_file_bytes":20000000} |
פרמטרmaterial_types | מפרטtext, image |
פרמטרadditional_properties | מפרטfalse |
כינויים לשיטה: /v1/videos/generations, /videos, /videos/generations
מחזור חיים: submit_once_poll_original
GET /v1/videos/{request_id}
GET /v1/videos/generations/{request_id}
GET /v1/videos/{request_id}/content
GET /v1/videos/generations/{request_id}/content
יש ליצור פעם אחת ולשמור את המזהה שהוחזר.
יש לבדוק במחזוריות את הסטטוס המקורי; יש לשמור כל נכס שהושלם ואת משכו.
תעריפים
מידע תעריפים אינו מוסיף אפשרויות לבקשה. הפרמטרים הנתמכים מפורטים בשיטה שנבחרה.
- מצב מהיר
- לא צוין כאשר נבחר מצב מהיר
- מצב Flex
- לא צוין כאשר נבחר מצב flex
- מאמץ חשיבה מרבי
- לא צוין כאשר מאמץ החשיבה המרבי משתמש בהתאמת ברירת המחדל (default)
תעריפי Ailoot
מחירים לפי תצורה
התאימו כל חיוב לתנאים המוצגים. השתמשו בתעריף אחד לכל קבוצה של תצורות חלופיות.
| תצורה | טבלת תעריפים | משך נומינלי של קטע, בשניות | רזולוציה | יחידת חיוב | חיוב |
|---|---|---|---|---|---|
| תצורהתעריפי בסיס לטוקנים | טבלת תעריפיםתעריף בסיס | משך נומינלי של קטע, בשניות— | רזולוציה— | יחידת חיוב— | חיוב קלט · טוקני קלט — / 1K טוקנים פלט · טוקני פלט — / 1K טוקנים קלט · קריאה מהמטמון — / 1K טוקנים קלט · כתיבה למטמון — / 1K טוקנים קלט · כתיבה למטמון, 1 שעה — / 1K טוקנים |
| תצורהUltra | טבלת תעריפים— | משך נומינלי של קטע, בשניות6 | רזולוציה768P | יחידת חיובלכל קטע פלט באורך נומינלי של 6s | חיוב פלט · מקטע פלט באורך נומינלי של 6s $0.4 לכל קטע פלט באורך נומינלי של 6s |
לפני הבקשה Ailoot משריינת סכום משוער. לאחר קבלת התוצאה היא מסדירה את החיוב הסופי לפי השימוש המדוד. הסדרת חיוב בהזרמה משתמשת ברשומת השימוש הסופית. איך פועלים שריון הסכום והסדרת החיוב →
פרטי תעריף הייחוס
טבלאות הייחוס ברמת המודל אינן משנות את בחירת השיטה, הצעות המחיר או החיובים. החיובים בפועל משתמשים בתעריפי שיטת Ailoot שנבחרה.
MiniMax-Hailuo-2.3-Fast
מחירים לפי תצורה
| תצורה | תנאי חיוב | חיוב |
|---|---|---|
| תצורהMiniMax-Hailuo-2.3-Fast · תצורת ברירת המחדל | תנאי חיובתצורת ברירת מחדל | חיוב קלט · קלט 0.00 $ לקריאה פלט · פלט 0.40 $ לקריאה |
MiniMax-Hailuo-2.3-Fast
מחירים לפי תצורה
| תצורה | תנאי חיוב | חיוב |
|---|---|---|
| תצורהMiniMax-Hailuo-2.3-Fast · תצורת ברירת המחדל | תנאי חיובתצורת ברירת מחדל | חיוב קלט · קלט 0.00 $ לקריאה פלט · פלט 0.80 $ לקריאה |
MiniMax-Hailuo-2.3-Fast
מחירים לפי תצורה
| תצורה | תנאי חיוב | חיוב |
|---|---|---|
| תצורהMiniMax-Hailuo-2.3-Fast · תצורת ברירת מחדל | תנאי חיובתצורת ברירת מחדל | חיוב קלט · קלט 0.00 $ לקריאה פלט · פלט 0.80 $ לקריאה |
דוגמאות לבקשות
Ailoot Ultra · וידאו
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
: "${AILOOT_IMAGE_URL:?Set the actual HTTPS first-frame image URL}"
export AILOOT_IMAGE_URL
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p=json.loads('{"model": "MiniMax-Hailuo-2.3-Fast", "prompt": "A cat in a spacesuit walking on the Moon", "duration": 6, "resolution": "768P"}')
from urllib.parse import urlsplit
u=os.environ["AILOOT_IMAGE_URL"]
z=urlsplit(u)
if z.scheme!="https" or not z.netloc or z.username or z.password:raise SystemExit("Choose the actual HTTPS first-frame image URL")
p["first_frame_image"]=u
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/videos \
-H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
--data-binary @request.json -D response-headers.txt -o result.json
קבלה ושמירה של תוצאות
Ailoot Ultra · וידאו
mp4
GET /v1/videos/{request_id}GET /v1/videos/generations/{request_id}GET /v1/videos/{request_id}/contentGET /v1/videos/generations/{request_id}/content
בדיקת מצב המשימה
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
python3 - <<'PY_STATUS_URL'
import json
from pathlib import Path
from urllib.parse import quote
r=json.loads(Path('result.json').read_text())
if not isinstance(r.get('id'),str) or not r['id']:raise SystemExit('Keep the original response and headers for reconciliation; no returned ID')
Path('status-url.txt').write_text('https://api.ailoot.ai/v1/videos/'+quote(r['id'],safe=''))
PY_STATUS_URL
curl --fail-with-body --silent --show-error "$(cat status-url.txt)" \
-H "Authorization: Bearer $AILOOT_API_KEY" -D status-headers.txt -o status.json
python3 - <<'PY_RESULT'
import json
from pathlib import Path
r=json.loads(Path('status.json').read_text())
print(json.dumps(r,ensure_ascii=False,indent=2))
print('Keep the complete JSON and response headers; do not resubmit an unknown creation.')
PY_RESULT
קריאות תוכן נוספות
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
export AILOOT_API_KEY
python3 - <<'PY_ASSETS'
import json,os,subprocess
from pathlib import Path
from urllib.parse import urljoin,urlsplit
r=json.loads(Path('status.json').read_text())
if r.get('status')!='completed':raise SystemExit('Keep the original ID and read its status; never recreate an unknown job')
if not isinstance(r.get('data'),list) or not r['data']:raise SystemExit('Keep the complete original status; no completed outputs supplied')
urls=[]
for i,u in enumerate(r.get('data',[])):
if not isinstance(u,str):raise SystemExit('Keep the original response; unexpected asset shape')
urls.append((str(i),u))
for label,path in urls:
u=urljoin('https://api.ailoot.ai',path);z=urlsplit(u)
if z.scheme!='https' or z.netloc!='api.ailoot.ai' or z.username or z.password:raise SystemExit('Use the actual returned Ailoot owned content URL')
target=Path('owned-'+label+'.bin')
subprocess.run(['curl','--fail-with-body','--silent','--show-error',u,'-H','Authorization: Bearer '+os.environ['AILOOT_API_KEY'],'-D',str(target)+'.headers','-o',str(target)],check=True)
print('All returned owned URLs saved; complete metadata, timing and usage remain in the JSON.')
PY_ASSETS
שמירת כל התוצאות שהושלמו
שמרו כל וידאו שהושלם או קובץ שהוחזר; אחזרו כל נכס מכל URL שהוחזר בפועל.
data[] שהושלם מכיל את כל כתובות ה־URL החתומות לתוכן שבבעלותכם. יש לאחזר כל כתובת URL שהוחזרה, או להשתמש בנקודת הקצה לתוכן עם index המוגדר לאינדקס של פלט ממשי. משימה מקורית שנכשלה עשויה להחזיר charge_pending_check; יש לבדוק את המשימה המקורית הזו במקום ליצור אותה שוב.
כשצריך לבדוק את התגובה המקורית
יש לקרוא את המשימה המקורית הקיימת; אין לשלוח שוב בקשה שתוצאת שליחתה אינה ידועה.
מספר פלטים מרבי: 1.
שדות התגובה
| שדה | סוג | משמעות |
|---|---|---|
שדהid | סוגstring | משמעות— |
שדהobject | סוגstring | משמעות— |
שדהmodel | סוגstring | משמעות— |
שדהstatus | סוגstring | משמעות— |
שדהdata[] | סוגsigned content URL | משמעות— |
שדהcharge_pending_check | סוגboolean | משמעות— |
שדהerror.code | סוגstring | משמעות— |
שדהerror.message | סוגstring | משמעות— |
שדהrequested_nominal_duration_seconds | סוגinteger | משמעות— |
שדהmeasured_duration_seconds | סוגnumber | משמעות— |
שדהwidth | סוגinteger | משמעות— |
שדהheight | סוגinteger | משמעות— |
שדהoperation_id | סוגstring | משמעותמוחזר כאשר status=unknown; המזהה הציבורי הממשי של פעולת הווידאו המקורית |
שדהrequest_id | סוגstring | משמעותאופציונלי כאשר status=unknown; מוחזר רק אם למשימה המקורית יש מזהה בקשה |
שגיאות והשלבים הבאים
| תגובה | תנאי | השלב הבא |
|---|---|---|
תגובה400 · invalid_request_error | תנאיקריאת גוף הבקשה הגולמי נכשלת לפני פענוח פרופיל הווידאו | השלב הבאיש לשמור את התגובה שהוחזרה ולתקן את גוף הבקשה שלא ניתן לקרוא. |
תגובה422 · price_unavailable | תנאיפענוח פרופיל הווידאו המדויק נכשל, או שלפרופיל המלא שפוענח אין כרטיס מחיר מדויק ומוכן | השלב הבאיש לשמור את התגובה; יש להשתמש בפרופיל המלא והמדויק שאושר ובכרטיס המחיר שפורסם עבורו. הענף הזה מתבצע לפני שליחה לספק. |
תגובה409 · video_not_ready | תנאיתוכן התוצאה המקורית עדיין אינו זמין | השלב הבאיש לבדוק במחזוריות את המזהה המקורי שהוחזר ולכבד את Retry-After. |
תגובהserver_error | תנאיהתשובה שהוחזרה מציינת שהפעולה או התוצאה דורשת בדיקה | השלב הבאשמרו את מזהה הפעולה/המשימה המקורי שהוחזר, את כותרות הבקשה ואת התשובה; המשיכו לבצע פעולות קריאה נתמכות של אותה פעולה מקורית. אל תשלחו שוב את בקשת היצירה. |
תגובה200 · video_result_unverified | תנאימצב משימת Fast המקורית אינו ידוע; status=unknown ו־charge_pending_check=true | השלב הבאיש לשמור את id/operation_id שהוחזרו בפועל ואת request_id האופציונלי; יש לקרוא רק את המשימה המקורית. אין לשלוח שוב. |
כינויים
כינויים למודל
Ailoot Ultra MiniMax-Hailuo-2.3-Fast
כינויים לנתיבי שיטות
/v1/videos/generations, /videos, /videos/generations
מזהי מודלים קשורים IDs
FAQ · Hailuo 2.3 Fast
- אילו קלטים ותוצאות זמינים?
POST /v1/videos·MiniMax-Hailuo-2.3-Fast:text,image→video- באילו שדות הבקשה משתמשת?
POST /v1/videos·MiniMax-Hailuo-2.3-Fast:model,prompt,duration,resolution,first_frame_image- אילו מגבלות חלות?
POST /v1/videos·MiniMax-Hailuo-2.3-Fast:prompt.maximum_length:199