MiniMax: I2V 01 Director
يحرّك I2V 01 Director صورة إطار أول بأوامر صريحة لحركة الكاميرا داخل الموجّه. اجمع التكوين المقدم مع أوامر truck وpan وpush وtilt وzoom وtracking أو تعليمات كاميرا ثابتة لتخطيط لقطة قصيرة.
عن النموذج
يغطي هذا الوصف قدرات النموذج. وترد أدناه المدخلات والمخرجات والخيارات المتاحة في Ailoot للطريقة المحددة.
I2V 01 Director هو إصدار MiniMax لتحويل صورة إلى فيديو مع أوامر كاميرا موثقة. تثبت صورة مقدمة الإطار الأول، ويوجه الموجّه الفعل المرئي والكاميرا معًا. ويفيد ذلك عندما يحتاج تكوين موجود إلى اقتراب معين أو كشف أو حركة تتبع أو منظر ثابت مضبوط، بدلًا من تحريك غير محدد.
جهّز الصورة كبداية اللقطة المقصودة. وللكشف، أظهر الموضوع والجزء من البيئة الذي ينبغي أن تكشفه الكاميرا. ولاقتراب قريب، ابدأ بمساحة محيطة كافية لإظهار تغير التأطير بوضوح. وتحقق من ظهور سمات الموضوع المهمة قبل بدء الحركة، خصوصًا عندما يجب أن يظل شكل منتج أو مظهر شخصية قابلًا للتعرف.
تقبل الشركة المصنّعة مراجع JPG وJPEG وPNG وWebP بحجم أقل من 20 MB، وضلع قصير يزيد على 300 بكسل، ونسبة أبعاد بين 2:5 و5:2. ويمكن لرابط صورة قابل للوصول أو بيانات صورة مرمّزة تحديد الإطار الأول ضمن مسار الشركة المصنّعة. احتفظ بالمرجع الأصلي حتى يستخدم التنقيح اللاحق التكوين نفسه، لا نسخة تقريبية أُعيد إنشاؤها.
يدعم الموجّه ما يصل إلى 2,000 محرف ويتضمن خمسة عشر أمر كاميرا مسمّى. ينقل Truck الكاميرا أفقيًا، ويغير pan اتجاهها الأفقي، وينقل pedestal الكاميرا رأسيًا، ويغير tilt اتجاهها الرأسي. وتوفر Push وpull وzoom أنواعًا مختلفة من الاقتراب أو الابتعاد؛ وتغطي tracking وshake واللقطة الثابتة مقاصد كاميرا أخرى. استخدم التهجئة الموثقة للأمر عند تحديد حركة.
ضع الأوامر داخل أقواس مربعة في موضع الوصف الذي ينبغي أن تحدث فيه الحركة. وتطلب عدة أوامر داخل قوس واحد حركة متزامنة، بينما تصف الأوامر في نقاط متتابعة تسلسلًا. وتوصي الشركة المصنّعة بحد أقصى يبلغ ثلاث حركات مجمعة. فقد يوصل اقتراب push بسيط نحو موضوع تفصيلًا أوضح من عدة حركات تتنافس على اللقطة القصيرة نفسها.
صف حركة الموضوع بصورة منفصلة عن حركة الكاميرا. فشخص يسير نحو باب وكاميرا تتبع ذلك الشخص تعليمتان لهما أثران مرئيان مختلفان. اذكر العلاقة المطلوبة بينهما، مثل إبقاء الوجه ظاهرًا أثناء الاقتراب أو تثبيت الكاميرا بينما يعبر الموضوع الإطار. وحدد التكوين النهائي حتى تكون للفعل المولد وجهة مفيدة.
يدرج جدول الشركة المصنّعة القديم للصورة إلى فيديو دقة 720P كافتراضي لهذا الإصدار، ولا يدرج خيارًا لمدة عشر ثوانٍ. ويُفعّل تحسين الموجّه التلقائي افتراضيًا، ويمكن تعطيله لتحكم أدق في الوصف المكتوب. احتفظ بإعداده مع الصورة المصدرية وتعليمات الكاميرا عند مقارنة اللقطات، حتى يظهر أي تغير في الصياغة أو التفسير داخل سجل التوليد.
راجع المقطع كاملًا للتحقق من مسار الكاميرا المطلوب واستمرارية الموضوع وتأطير التفاصيل المهمة. وافحص ما إذا كانت حركة push أوpan تكشف المعلومات المقصودة وما إذا كان المنظر النهائي يترك مساحة كافية لخطوة التحرير التالية. احفظ الفيديو المكتمل مع الموجّه والصورة المصدرية والإعدادات الدقيقة. ولتنقيح، غيّر اتجاه الكاميرا أو التوقيت أو فعل الموضوع الذي تسبب في المشكلة الملحوظة، وقارن النتيجة بخطة اللقطة نفسها.
Ailoot Ultra · فيديو POST /v1/videos minimaxi-i2v-01-director
minimaxi-i2v-01-directorالبداية
يحرّك I2V 01 Director صورة إطار أول بأوامر صريحة لحركة الكاميرا داخل الموجّه. اجمع التكوين المقدم مع أوامر truck وpan وpush وtilt وzoom وtracking أو تعليمات كاميرا ثابتة لتخطيط لقطة قصيرة.
- المدخلات المقبولة
- النص · الصور
- النتائج
- فيديو
متاح في Ailoot · المدخلات والطرائق
Ailoot Ultra · فيديو POST /v1/videos
- الإدخال
text,image- الإخراج
video
| الحقل | النوع | المتطلب | القيم والحدود | القيمة الافتراضية |
|---|---|---|---|---|
الحقلmodel | النوعstring | المتطلبمطلوب | القيم والحدود minimaxi-i2v-01-director الشروط: استخدم محدِّد نموذج Ailoot الدقيق. | القيمة الافتراضية— |
الحقلprompt | النوعstring | المتطلبمطلوب | القيم والحدود الشروط: صِف المشهد والحركة. | القيمة الافتراضية— |
الحقلend_image | النوعstring | المتطلباختياري | القيم والحدود الشروط: ينطبق إطار النهاية في نمط إدخال صور مدعوم فقط. | القيمة الافتراضية— |
الحقلimage | النوعstring or array<string> | المتطلباختياري | القيم والحدود الشروط: استخدم عنوان URL فعلياً لصورة يمكن الوصول إليها علناً أو سلسلة صورة بترميز base64؛ ولا يُفترض هنا حد أقصى لعدد الصور. | القيمة الافتراضية— |
معلمات الطريقة ودورة حياتها
| المعلمة | المواصفات |
|---|---|
المعلمةcontent_type | المواصفاتapplication/json |
المعلمةrequired | المواصفاتmodel, prompt |
المعلمةoptional | المواصفاتend_image, image |
المعلمةmaterial_types | المواصفاتtext, image |
المعلمةconditions | المواصفاتاستخدم محدِّد نموذج Ailoot الدقيق., صِف المشهد والحركة., ينطبق إطار النهاية في نمط إدخال صور مدعوم فقط., استخدم عنوان URL فعلياً لصورة يمكن الوصول إليها علناً أو سلسلة صورة بترميز base64؛ ولا يُفترض هنا حد أقصى لعدد الصور. |
الأسماء البديلة للطريقة: /v1/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/media/assets
GET /v1/media/assets/{asset_id}
الباقات
كيفية احتساب الرسوم النهائية
تقدّر التعرفات المعروضة التكلفة قبل التوليد. تُحسب الرسوم النهائية من التكلفة المسجّلة لعملية التوليد الأصلية. مدة المخرجات المقاسة والكميات المتوقعة ليست الكمية النهائية الخاضعة للفوترة.
مراجع التسعير لا تضيف خيارات للطلب. المعلمات المدعومة مذكورة للطريقة المحددة.
- الوضع السريع
- غير محدد عند اختيار الوضع السريع
- الوضع المرن
- غير محدد عند اختيار وضع flex
- أقصى جهد للاستدلال
- غير محدد عندما يُطبَّق الضبط الافتراضي default مع أقصى جهد للاستدلال
تعرفات تقديرية للمقارنة
الأسعار حسب الإعدادات
طابق كل رسم مع الشروط المعروضة. طبّق تعرفة واحدة لكل مجموعة من الإعدادات البديلة.
| الإعدادات | جدول التعرفة | الكمية المتوقعة | كمية الفوترة | الرسوم |
|---|---|---|---|---|
| الإعداداتالتعرفات الأساسية للرموز | جدول التعرفةالتعرفة الأساسية | الكمية المتوقعة— | كمية الفوترة— | الرسوم الإدخال · رموز الإدخال · تقدير للمقارنة فقط — / 1K من الرموز الإخراج · رموز الإخراج · تقدير للمقارنة فقط — / 1K من الرموز الإدخال · قراءة ذاكرة التخزين المؤقت · تقدير للمقارنة فقط — / 1K من الرموز الإدخال · الكتابة إلى ذاكرة التخزين المؤقت · تقدير للمقارنة فقط — / 1K من الرموز الإدخال · الكتابة إلى ذاكرة التخزين المؤقت، 1 ساعة · تقدير للمقارنة فقط — / 1K من الرموز |
| الإعداداتلكل طلب | جدول التعرفة— | الكمية المتوقعة— | كمية الفوترةطلب واحد | الرسوم الإدخال · تقدير للمقارنة فقط $1 لكل طلب |
| الإعداداتتكلفة التوليد التقديرية | جدول التعرفة— | الكمية المتوقعةتقدير لتوليد واحد | كمية الفوترة— | الرسوم الإخراج · تكلفة التوليد التقديرية · تقدير للمقارنة فقط $1 تقدير قبل الإنشاء هذا التقدير ليس رسومًا إضافية ولا تعرفة ثابتة لعملية التوليد المكتملة. |
تحجز Ailoot مبلغًا تقديريًا قبل الطلب. وبعد ظهور النتيجة، تُسوّي الرسوم النهائية بناءً على الاستخدام المقاس. وتستخدم تسوية البث سجل الاستخدام النهائي. كيفية عمل حجز المبلغ وتسوية الرسوم →
أمثلة للطلبات
Ailoot Ultra · فيديو
# Replace YOUR_ACCESSIBLE_IMAGE_URL with your actual reachable reference image URL.
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
cat > request.json <<'JSON'
{
"model": "minimaxi-i2v-01-director",
"prompt": "A cat is walking on grass.",
"image": "YOUR_ACCESSIBLE_IMAGE_URL"
}
JSON
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
# Create once; retain id, polling_url, original task identifiers and every header.
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
export AILOOT_API_KEY
python3 - <<'PY_STATUS'
import json,os,subprocess
from pathlib import Path
from urllib.parse import urljoin,urlsplit
r=json.loads(Path("result.json").read_text())
u=urljoin("https://api.ailoot.ai",r["polling_url"])
p=urlsplit(u)
if p.scheme!="https" or p.netloc!="api.ailoot.ai" or p.username or p.password:
raise SystemExit("Unexpected returned polling URL; preserve the response")
subprocess.run(["curl","--fail-with-body","--silent","--show-error",u,"-H","Authorization: Bearer "+os.environ["AILOOT_API_KEY"],"-D","status-headers.txt","-o","status.json"],check=True)
# Read this same original polling_url again while pending.
# Preserve unknown/result_pending_check; do not repeat creation.
PY_STATUS
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())
roles={}
def visit(v,path=""):
if isinstance(v,dict):
for k,x in v.items(): visit(x,path+"/"+k)
elif isinstance(v,list):
for i,x in enumerate(v): visit(x,path+"/"+str(i))
elif isinstance(v,str):
u=urljoin("https://api.ailoot.ai",v); p=urlsplit(u)
if p.scheme=="https" and p.netloc=="api.ailoot.ai" and not p.username and not p.password and p.path.startswith("/v1/media/assets/") and p.path.endswith("/content"):
roles.setdefault(u,[]).append(path)
visit(r)
if not roles: raise SystemExit("No completed owned assets; retain the original status")
manifest=[]
for i,(u,paths) in enumerate(roles.items()):
target=Path(f"asset-{i}.bin")
subprocess.run(["curl","--fail-with-body","--silent","--show-error",u,"-H","Authorization: Bearer "+os.environ["AILOOT_API_KEY"],"-o",str(target)],check=True)
raw=target.read_bytes()
if not raw: raise SystemExit("Empty asset; retain original status and metadata")
ext="glb" if raw[:4]==b"glTF" else "png" if raw[:8]==b"\x89PNG\r\n\x1a\n" else "jpg" if raw[:3]==b"\xff\xd8\xff" else "webp" if raw[:4]==b"RIFF" and raw[8:12]==b"WEBP" else "mp4" if raw[4:8]==b"ftyp" else "bin"
name=f"asset-{i}.{ext}"
if target.name!=name: target.rename(name)
manifest.append({"file":name,"response_paths":paths,"bytes":len(raw)})
Path("asset-manifest.json").write_text(json.dumps(manifest,indent=2))
print("Saved",len(manifest),"unique owned assets; every response role retained")
PY_ASSETS
استلام النتائج وحفظها
Ailoot Ultra · فيديو
GET /v1/videos/{request_id}GET /v1/videos/generations/{request_id}GET /v1/videos/{request_id}/contentGET /v1/media/assetsGET /v1/media/assets/{asset_id}
الاحتفاظ بكل النتائج المكتملة
احفظ كل فيديو مكتمل أو ملف مُرجع؛ ونزّل كل أصل من URL الخاص به الذي تم إرجاعه فعليًا.
احتفظ بالاستجابة والترويسات كاملة، والمعرّفات الأصلية، وكل مخرج فعلي، وجميع حقول الاستخدام والمحاسبة. احفظ كل أصل فريد مملوك لك، واحتفظ بكل دور يشير إليه.
عند الحاجة إلى التحقق من الاستجابة الأصلية
احتفظ بالمعرّف العام المُعاد للمهمة أو العملية وبجميع الترويسات. اقرأ المهمة الأصلية فقط؛ فالحالة unknown أو result_pending_check لا تمنح الإذن بإنشاء مهمة أخرى.
حقول الاستجابة
| الحقل | النوع |
|---|---|
الحقلid | النوعstring |
الحقلpolling_url | النوعstring |
الحقلprovider_task_id | النوعstring |
الحقلtask_id | النوعstring |
الحقلstatus | النوعstring |
الحقلvideo_url | النوعstring |
الأسماء البديلة
الأسماء البديلة للنموذج
Ailoot Ultra minimaxi-i2v-01-director
الأسماء البديلة لمسارات الطرائق
/v1/videos/generations
معرّفات النماذج ذات الصلة IDs
FAQ · MiniMax: I2V 01 Director
- ما المدخلات والنتائج المتاحة؟
POST /v1/videos·minimaxi-i2v-01-director:text,image→video- ما الحقول التي يستخدمها الطلب؟
POST /v1/videos·minimaxi-i2v-01-director:model,prompt,end_image,image