Alibaba: HappyHorse 1.1

يولّد Alibaba HappyHorse 1.1 مقاطع فيديو قصيرة بصوت من وصف نصي أو صورة واحدة للإطار الأول أو ما يصل إلى تسع صور مرجعية. وتركّز ملفاته لدى الجهة المطوّرة على تحسين الحركة وتفاصيل البشرة واتساق الشخصية بين المقاطع. والمخرجات MP4 مدتها 3–15 ثانية بمعدل 24 إطارًا في الثانية، مع خيارات 480p أو 720p أو 1080p.

Ailoot Ultra · فيديو POST /v1/videos alibaba/happyhorse-1.1

عن النموذج

يغطي هذا الوصف قدرات النموذج. وترد أدناه المدخلات والمخرجات والخيارات المتاحة في Ailoot للطريقة المحددة.

Alibaba HappyHorse 1.1 إصدار لتوليد الفيديو يضم ملفات تعريف مستقلة مسماة لتحويل النص إلى فيديو وتحويل صورة الإطار الأول إلى فيديو والتحويل من المراجع إلى فيديو. وتركّز الجهة المصنّعة على تحسين التفاصيل البصرية والحركة وهوية الشخصية بين المقاطع وثبات النص والتزامن بين الصوت والصورة. والناتج فيديو قصير بصوت، مفيد للقطة منتج أو تحريك صورة شخصية أو مشهد قصير لشخصية. اختر وضع الإدخال وفق ما ينبغي أن يحدّد المشهد: فكرة مكتوبة أو صورة افتتاحية دقيقة أو عدة مراجع بصرية.

لتحويل النص إلى فيديو، صِف العنصر الرئيسي والموقع والفعل والتأطير وحركة الكاميرا والقصد الصوتي. ولمشهد حركة قصير، اعرض راكب دراجة يتوقّف بجوار مقهى على ضفة نهر، بينما تتحرّك الكاميرا برفق نحو الدراجة المتوقفة. اجعل الفعل مناسبًا لمقطع قصير وصِف اللحظة النهائية. ويسمح دليل النص الحالي لدى الجهة المطوّرة بما يصل إلى 5,000 حرف غير صيني أو 2,500 حرف صيني ويقتطع النص الزائد. نظّم التوجيه بحيث يكون العنصر والفعل الأساسيان صريحين بدلًا من دفنهما في صفات متكررة.

يستخدم تحويل صورة الإطار الأول إلى فيديو صورة واحدة بالضبط للافتتاح. جهّز العنصر والتكوين والاقتصاص المقصود في تلك الصورة الثابتة، ثم صِف ما ينبغي أن يتحرّك أو كيف ينبغي للكاميرا أن تتغيّر. وصيغ الصور الموثّقة هي JPEG/JPG وPNG وWEBP، حتى 20 MB، مع كل من البعدين لا يقل عن 300 بكسل ونسبة أبعاد بين 1:2.5 و2.5:1. تقارب المخرجات فئة الدقة المختارة مع الاحتفاظ بنسب الصورة المصدرية. ولذلك تبدأ النتيجة الرأسية بتكوين رأسي مناسب، لا بتعليمات غير مرتبطة عن نسبة الأبعاد.

يقبل التحويل من المراجع إلى فيديو من صورة واحدة إلى تسع صور. ويستخدم التوجيه [Image 1] و[Image 2] والمواضع اللاحقة لتعريفها بحسب ترتيب الإدخال. حدّد دور كل مرجع وسمِّ الجسم أو الشخص المعني، كي لا تُفهم صورة مشهد على أنها مصدر للشخصية. يقبل دليل المراجع JPEG/JPG أو PNG أو WEBP حتى 20 MB، ويشترط ألّا يقل الضلع الأقصر عن 400 بكسل، ويوصي بمراجع واضحة بدقة 720p أو أعلى. تجنّب مرجعًا مضغوطًا بشدة فقد تفاصيله المعرِّفة مسبقًا.

لمشهد بعدة مراجع، ضع الشخص من صورة في الغرفة من صورة أخرى، مع الاحتفاظ بمعطف أو منتج مقدَّم في صورة ثالثة. صِف التفاعل والكاميرا في التوجيه نفسه. ويبرز ملف المراجع 1.1 ثبات العناصر وأسلوب المشهد والحركة السينمائية؛ افحص النتيجة الفعلية من حيث الهوية المقصودة وعلامات المنتج والتموضع المكاني. تمنح الصور المتعددة التوجيه معلومات أكثر، لكن المراجعة تظل بحاجة إلى التحقّق من السمات التي انتقلت إلى الفيديو.

تسرد الجهة المطوّرة دقات إخراج 480p و720p و1080p لأوضاع توليد 1.1، بمدة من ثلاث إلى خمس عشرة ثانية بعدد صحيح من الثواني، وملف MP4 بمعدل 24 إطارًا في الثانية. وتصف استجابة API ترميز H.264. ويوفّر التوليد النصي والمرجعي أشكالًا تشمل 16:9 و9:16 و1:1 و4:3 و3:4 و4:5 و5:4 و9:21 و21:9؛ بينما يتبع التوليد من الإطار الأول الصورة المدخلة. اختر الشكل وفق الوجهة واترك مجالًا للتسميات أو عناصر التخطيط اللاحقة. افحص التأطير الفعلي للفيديو الناتج بحجم العرض المقصود.

تشمل مخرجات عائلة النموذج صوتًا. امنح الأداء أو الأجواء دورًا واضحًا في التوجيه، وراجع أي حوار أو مؤثرات أو مسار خلفي مع الصورة. اجعل المحتوى المنطوق قصيرًا بما يكفي للفعل والوقفات، بدلًا من ضغط نص طويل في لقطة قصيرة واحدة. تحقّق من حركة الشفاه ونسبة الصوت إلى المتحدّث والألفاظ الفعلية عند وجود كلام. وقبول لغة التوجيه لا يحدّد في حد ذاته ضمانًا للنطق أو مدخلًا مستقلًا لمرجع صوتي.

مسار الجهة المطوّرة الموثّق غير متزامن: يتتبّع معرّف المهمة المعالجة، وتوفّر النتيجة الناجحة موقع الفيديو. ويُوثَّق رابط النتيجة واستعلامات المهام بصلاحية أربع وعشرين ساعة. احتفظ بالمقطع المكتمل والمراجع والتوجيه كسجل للمراجعات. وتوثّق الأدلة أيضًا عناصر تحكّم في البذرة والعلامة المائية. وقد تساعد البذرة الثابتة في المقارنة، لكن الجهة المطوّرة تنص صراحة على أنها لا تضمن نتائج مطابقة، لذا احكم على الملف الناتج بدلًا من افتراض أن إعدادًا واحدًا يثبّت كل إطار.

HappyHorse 1.0 و1.1 إصداران مستقلان. يضيف جدول مخرجات 1.1 دقة 480p إلى خيارَي 720p و1080p في 1.0، وتصف صفحات نموذج 1.1 ترقيات في التفاصيل والحركة والاتساق. ولملف تحرير الفيديو المستقل المسمّى HappyHorse 1.0 مدخلاته وحدوده الخاصة، وهو ليس وضع تحرير يُنسب ضمنيًا إلى 1.1. راجع مقطع 1.1 كاملًا من حيث الهوية والحركة والتأطير والنص والصوت، ثم أجرِ تصحيحًا محدّدًا مع الاحتفاظ بالأجزاء الناجحة من التوجيه.

Ailoot Ultra · فيديو POST /v1/videos alibaba/happyhorse-1.1

alibaba/happyhorse-1.1

Alibaba /alibaba/happyhorse-1.1

البداية

المدخلات المقبولة: النص
النتائج: فيديو

متاح في Ailoot · المدخلات والطرائق

Ailoot Ultra · فيديو POST /v1/videos

الإدخال: text
الإخراج: video
صيغة الإخراج: mp4
عدد المخرجات: حتى ⁦4⁩ إخراجs

الحقل	النوع	المتطلب	القيم والحدود	القيمة الافتراضية
الحقل`model`	النوع`string`	المتطلبمطلوب	القيم والحدود alibaba/happyhorse-1.1	القيمة الافتراضية—
الحقل`prompt`	النوع`string`	المتطلبمطلوب	القيم والحدود الحد الأدنى للطول: ⁦1⁩ الحد الأقصى للبايتات: ⁦10,000⁩ الوحدة: بايتات UTF8	القيمة الافتراضية—
الحقل`duration`	النوع`integer`	المتطلبمطلوب	القيم والحدود الحد الأدنى: ⁦3⁩ الحد الأقصى: ⁦15⁩ الوحدة: ثوانٍ	القيمة الافتراضية—
الحقل`resolution`	النوع`string`	المتطلبمطلوب	القيم والحدود 720p	القيمة الافتراضية—
الحقل`aspect_ratio`	النوع`string`	المتطلبمطلوب	القيم والحدود 16:9	القيمة الافتراضية—

تركيبات مواد الإدخال

تحويل النص إلى فيديو · مطلوب: prompt

معلمات الطريقة ودورة حياتها

المعلمة	المواصفات
المعلمة`content_type`	المواصفاتapplication/json
المعلمة`required`	المواصفاتmodel, prompt, duration, resolution, aspect_ratio
المعلمة`other_options`	المواصفاتfalse
المعلمة`resolution`	المواصفات720p
المعلمة`prompt_max_bytes`	المواصفات10000
المعلمة`duration_integer_range`	المواصفات3, 15
المعلمة`aspect_ratio`	المواصفات16:9
المعلمة`generate_audio`	المواصفاتيجب حذفه (ولا يُضبط على false)؛ يُضمَّن AAC
المعلمة`material_types`	المواصفاتtext
المعلمة`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 مع أقصى جهد للاستدلال

تعرفات تقديرية للمقارنة

الأسعار حسب الإعدادات

طابق كل رسم مع الشروط المعروضة. طبّق تعرفة واحدة لكل مجموعة من الإعدادات البديلة.

الإعدادات	جدول التعرفة	الكمية المتوقعة	وحدة الفوترة	شروط الفوترة	الرسوم
الإعداداتالتعرفات الأساسية للرموز	جدول التعرفةالتعرفة الأساسية	الكمية المتوقعة—	وحدة الفوترة—	شروط الفوترة—	الرسوم الإدخال · رموز الإدخال · تقدير للمقارنة فقط — / 1K من الرموز الإخراج · رموز الإخراج · تقدير للمقارنة فقط — / 1K من الرموز الإدخال · قراءة ذاكرة التخزين المؤقت · تقدير للمقارنة فقط — / 1K من الرموز الإدخال · الكتابة إلى ذاكرة التخزين المؤقت · تقدير للمقارنة فقط — / 1K من الرموز الإدخال · الكتابة إلى ذاكرة التخزين المؤقت، 1 ساعة · تقدير للمقارنة فقط — / 1K من الرموز
الإعداداتسعر الفيديو	جدول التعرفة—	الكمية المتوقعة—	وحدة الفوترةلكل ثانية فيديو	شروط الفوترةresolution: 1080p	الرسوم الإخراج · سعر الفيديو · تقدير للمقارنة فقط $0.2556 لكل ثانية فيديو
الإعداداتسعر الفيديو	جدول التعرفة—	الكمية المتوقعة—	وحدة الفوترةلكل ثانية فيديو	شروط الفوترةresolution: 720p	الرسوم الإخراج · سعر الفيديو · تقدير للمقارنة فقط $0.1976 لكل ثانية فيديو
الإعداداتتكلفة التوليد التقديرية	جدول التعرفة—	الكمية المتوقعةتقدير لتوليد واحد	وحدة الفوترة—	شروط الفوترة—	الرسوم الإخراج · تكلفة التوليد التقديرية · تقدير للمقارنة فقط $0.5928 تقدير قبل الإنشاء هذا التقدير ليس رسومًا إضافية ولا تعرفة ثابتة لعملية التوليد المكتملة.

تحجز Ailoot مبلغًا تقديريًا قبل الطلب. وبعد ظهور النتيجة، تُسوّي الرسوم النهائية بناءً على الاستخدام المقاس. وتستخدم تسوية البث سجل الاستخدام النهائي. كيفية عمل حجز المبلغ وتسوية الرسوم →

تفاصيل التعرفة المرجعية

لا تغيّر جداول التعرفة المرجعية على مستوى النموذج اختيار الطريقة أو عروض الأسعار أو الرسوم. وتستخدم الرسوم الفعلية تعرفات طريقة Ailoot المحددة.

مراجع أسعار إعدادات الفيديو

الأسعار حسب الإعدادات

طابق كل رسم مع الشروط المعروضة. طبّق تعرفة واحدة لكل مجموعة من الإعدادات البديلة.

الإعدادات	شروط الفوترة	الرسوم
الإعداداتسعر الفيديو	شروط الفوترةresolution: 720p	الرسوم الإخراج · سعر الفيديو $0.1976 لكل ثانية فيديو مرجع السعر المنشور للإعداد المعروض. تتبع الرسوم النهائية الإعداد الفعلي الذي تمت فوترته.
الإعداداتسعر الفيديو	شروط الفوترةresolution: 1080p	الرسوم الإخراج · سعر الفيديو $0.2556 لكل ثانية فيديو مرجع السعر المنشور للإعداد المعروض. تتبع الرسوم النهائية الإعداد الفعلي الذي تمت فوترته.

أمثلة للطلبات

Ailoot Ultra · فيديو

curl · طلب الإنشاء المحفوظ بحذافيره

set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p=json.loads('{"model": "alibaba/happyhorse-1.1", "prompt": "A cat in a spacesuit walking on the Moon", "duration": 3, "resolution": "720p", "aspect_ratio": "16:9"}')

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}/content
GET /v1/videos/generations/{request_id}/content

التحقق من حالة المهمة

GET · جلب حالة العملية الأصلية

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؛ تحقق من تلك المهمة الأصلية بدلاً من إنشائها مرة أخرى.

عند الحاجة إلى التحقق من الاستجابة الأصلية

اقرأ المهمة الأصلية الموجودة؛ ولا تعِد إرسال طلب مجهول النتيجة مطلقاً.

الحد الأقصى للمخرجات: ⁦4⁩.

حقول الاستجابة

الحقل	النوع	المعنى
الحقل`id`	النوعstring	المعنى—
الحقل`object`	النوعstring	المعنى—
الحقل`model`	النوعstring	المعنى—
الحقل`status`	النوعstring	المعنى—
الحقل`data[]`	النوعsigned content URL	المعنى—
الحقل`charge_pending_check`	النوعboolean	المعنى—
الحقل`error.code`	النوعstring	المعنى—
الحقل`error.message`	النوعstring	المعنى—
الحقل`operation_id`	النوعstring	المعنىاستجابة الحالة أو المحتوى الأصليين عند HTTP503 result_pending_check: المعرّف العام للفيديو الأصلي نفسه في الحقل id.
الحقل`error.type`	النوعstring	المعنىserver_error عند HTTP503 result_pending_check.

الأخطاء والخطوات التالية

الاستجابة	الشرط	الخطوة التالية
الاستجابة⁦400⁩ · `invalid_request_error`	الشرطتفشل قراءة متن الطلب الخام قبل تحليل ملف إعداد الفيديو	الخطوة التاليةاحتفظ بالاستجابة المُعادة وصحّح متن الطلب الذي تعذرت قراءته.
الاستجابة⁦422⁩ · `price_unavailable`	الشرطيتعذر تحليل ملف إعداد الفيديو الدقيق، أو لا تتوفر بطاقة سعر دقيقة وجاهزة لملف الإعداد الكامل بعد تحليله	الخطوة التاليةاحتفظ بالاستجابة؛ واستخدم ملف الإعداد الدقيق المسموح به كاملاً وبطاقة سعره المنشورة. يُنفَّذ هذا الفرع قبل الإرسال إلى المزوّد.
الاستجابة⁦409⁩ · `video_not_ready`	الشرطمحتوى النتيجة الأصلية غير متاح بعد	الخطوة التاليةاستعلم دورياً باستخدام المعرّف الأصلي المُعاد والتزم بـRetry-After.
الاستجابة`server_error`	الشرطتشير الاستجابة المُعادة إلى أن العملية أو النتيجة تتطلب التحقق	الخطوة التاليةاحتفظ بمعرّف العملية أو المهمة الأصلي المُعاد، وبترويسات الطلب وبالاستجابة؛ وواصل عمليات القراءة المدعومة لتلك العملية الأصلية. لا تُعِد إرسال طلب الإنشاء.
الاستجابة⁦503⁩ · `result_pending_check`	الشرطGET للحالة أو المحتوى الأصليين: المهمة غير منشورة، والمهمة الأصلية ليست في حالة failed/cancelled/expired، والحالة المحلية unknown أو حالة المهمة الأصلية completed.	الخطوة التاليةاحتفظ بـid وoperation_id الأصليين (المعرّف العام نفسه للفيديو)، وبالاستجابة والترويسات؛ واقرأ الحالة أو المحتوى الأصليين فقط. لا ترسل طلب توليد جديداً مطلقاً.

الأسماء البديلة

الأسماء البديلة للنموذج

Ailoot Ultra alibaba/happyhorse-1.1

الأسماء البديلة لمسارات الطرائق

/v1/videos/generations, /videos, /videos/generations

معرّفات النماذج ذات الصلة IDs

alibaba/happyhorse-1.1

FAQ · Alibaba: HappyHorse 1.1

ما المدخلات والنتائج المتاحة؟: POST /v1/videos · alibaba/happyhorse-1.1: text → video
ما الحقول التي يستخدمها الطلب؟: POST /v1/videos · alibaba/happyhorse-1.1: model, prompt, duration, resolution, aspect_ratio
ما الحدود المطبقة؟: POST /v1/videos · alibaba/happyhorse-1.1: duration.minimum: 3; duration.maximum: 15

Alibaba: HappyHorse 1.1