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
- أقصى جهد للاستدلال
- غير محدد عندما يُطبَّق الضبط الافتراضي 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 US$ لكل استدعاء الإخراج · الإخراج 0.40 US$ لكل استدعاء |
MiniMax-Hailuo-2.3-Fast
الأسعار حسب الإعدادات
| الإعدادات | شروط الفوترة | الرسوم |
|---|---|---|
| الإعداداتMiniMax-Hailuo-2.3-Fast · الإعداد الافتراضي | شروط الفوترةالإعداد الافتراضي | الرسوم الإدخال · الإدخال 0.00 US$ لكل استدعاء الإخراج · الإخراج 0.80 US$ لكل استدعاء |
MiniMax-Hailuo-2.3-Fast
الأسعار حسب الإعدادات
| الإعدادات | شروط الفوترة | الرسوم |
|---|---|---|
| الإعداداتMiniMax-Hailuo-2.3-Fast · الإعداد الافتراضي | شروط الفوترةالإعداد الافتراضي | الرسوم الإدخال · الإدخال 0.00 US$ لكل استدعاء الإخراج · الإخراج 0.80 US$ لكل استدعاء |
أمثلة للطلبات
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