HappyHorse-1.1-I2V هو نموذج من Alibaba يبدأ مشهد الفيديو بصورة جاهزة. تصبح الصورة الإطار الأول، ويمكن للنص تحديد ما يحدث بعده: حركة الشخصية، والتغيّرات في المشهد، واتجاه الكاميرا. يناسب ذلك تحريك رسم توضيحي أو صورة منتج أو تصور بصري مُعدّ مسبقًا.
الوصف النصي اختياري. إذا لم يُقدَّم، يستنتج النموذج الحركة الممكنة من محتوى الصورة الابتدائية. وعند تحديد الطلب صراحةً، تحدد الصورة الأصلية التكوين ومظهر العناصر، بينما توجّه الكلمات تطوّر المشهد مع الزمن.
تبرز Alibaba الحفاظ على مظهر الشخصية، والاتساق البصري، وسلاسة الحركة، والجمع بين الصورة والصوت. وتشمل المجالات المعلنة أيضًا ثبات الكتابات والخامات. تتعلق هذه الخصائص بالتصميم المقصود للنموذج، ولا تعني الحفاظ الحرفي على كل بكسل في جميع الإطارات المُولَّدة.
يستخدم هذا الوضع صورة ابتدائية واحدة. وهي تحدد المشهد الأصلي، وليست مجموعة عينات مستقلة لتكوين جديد. لم تُعلن إمكانية تحديد إطار ختامي منفصل لهذا الإصدار بعينه.
تُقبل JPEG وJPG وPNG وWEBP. يجب ألا يقل طول أي جانب من الصورة المدخلة عن 300 بكسل؛ ونسبة الأبعاد المسموح بها من 1:2,5 إلى 2,5:1، وحجم الملف حتى 20 ميغابايت. تتبع نسبة أبعاد الفيديو الناتج الإطار الأول.
تُختار المدة بعدد صحيح من 3 إلى 15 ثانية. تتوفر مستويات الدقة 480P و720P و1080P؛ وصيغة الإخراج MP4 بمعدل 24 إطارًا في الثانية. يُدعم إنشاء صوت مصاحب مع الفيديو.
يمكن كتابة الوصف بأي لغة، بحد أقصى 5000 حرف غير صيني أو 2500 حرف صيني. إذا تجاوز النص الحد، يُحذف الجزء الزائد، لذا ينبغي صياغة الحركات المهمة وخصائصها ضمن حجم الطلب. قد تعطي بذرة العشوائية الابتدائية نفسها فيديوهات متشابهة، لكنها لا تضمن تطابقها إطارًا بإطار.
", "aboutText": "HappyHorse-1.1-I2V هو نموذج من Alibaba يبدأ مشهد الفيديو بصورة جاهزة. تصبح الصورة الإطار الأول، ويمكن للنص تحديد ما يحدث بعده: حركة الشخصية، والتغيّرات في المشهد، واتجاه الكاميرا. يناسب ذلك تحريك رسم توضيحي أو صورة منتج أو تصور بصري مُعدّ مسبقًا.\n\nالوصف النصي اختياري. إذا لم يُقدَّم، يستنتج النموذج الحركة الممكنة من محتوى الصورة الابتدائية. وعند تحديد الطلب صراحةً، تحدد الصورة الأصلية التكوين ومظهر العناصر، بينما توجّه الكلمات تطوّر المشهد مع الزمن.\n\n### من الإطار الأول إلى الحركة\n\nتبرز Alibaba الحفاظ على مظهر الشخصية، والاتساق البصري، وسلاسة الحركة، والجمع بين الصورة والصوت. وتشمل المجالات المعلنة أيضًا ثبات الكتابات والخامات. تتعلق هذه الخصائص بالتصميم المقصود للنموذج، ولا تعني الحفاظ الحرفي على كل بكسل في جميع الإطارات المُولَّدة.\n\nيستخدم هذا الوضع صورة ابتدائية واحدة. وهي تحدد المشهد الأصلي، وليست مجموعة عينات مستقلة لتكوين جديد. لم تُعلن إمكانية تحديد إطار ختامي منفصل لهذا الإصدار بعينه.\n\nتُقبل JPEG وJPG وPNG وWEBP. يجب ألا يقل طول أي جانب من الصورة المدخلة عن 300 بكسل؛ ونسبة الأبعاد المسموح بها من 1:2,5 إلى 2,5:1، وحجم الملف حتى 20 ميغابايت. تتبع نسبة أبعاد الفيديو الناتج الإطار الأول.\n\n### إعدادات الفيديو\n\nتُختار المدة بعدد صحيح من 3 إلى 15 ثانية. تتوفر مستويات الدقة 480P و720P و1080P؛ وصيغة الإخراج MP4 بمعدل 24 إطارًا في الثانية. يُدعم إنشاء صوت مصاحب مع الفيديو.\n\nيمكن كتابة الوصف بأي لغة، بحد أقصى 5000 حرف غير صيني أو 2500 حرف صيني. إذا تجاوز النص الحد، يُحذف الجزء الزائد، لذا ينبغي صياغة الحركات المهمة وخصائصها ضمن حجم الطلب. قد تعطي بذرة العشوائية الابتدائية نفسها فيديوهات متشابهة، لكنها لا تضمن تطابقها إطارًا بإطار.", "editorialOverlay": { "copy_fields": null, "copy_sha256": null, "copy_source": null, "html_sha256": "e33a85ef20f0e03a11cde7cdb3d18235f0ca2df667bab7380499c4c631083050", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "ar", "methods": [ { "html": "happyhorse-1.1-i2vنموذج لتحريك الصور: تحدد الصورة الأصلية الإطار الأول، بينما يوجّه الوصف الحركة اللاحقة. ينشئ فيديو قصيرًا مع إمكانية إرفاق صوت.
يغطي هذا الوصف قدرات النموذج. وترد أدناه المدخلات والمخرجات والخيارات المتاحة في Ailoot للطريقة المحددة.
HappyHorse-1.1-I2V هو نموذج من Alibaba يبدأ مشهد الفيديو بصورة جاهزة. تصبح الصورة الإطار الأول، ويمكن للنص تحديد ما يحدث بعده: حركة الشخصية، والتغيّرات في المشهد، واتجاه الكاميرا. يناسب ذلك تحريك رسم توضيحي أو صورة منتج أو تصور بصري مُعدّ مسبقًا.
الوصف النصي اختياري. إذا لم يُقدَّم، يستنتج النموذج الحركة الممكنة من محتوى الصورة الابتدائية. وعند تحديد الطلب صراحةً، تحدد الصورة الأصلية التكوين ومظهر العناصر، بينما توجّه الكلمات تطوّر المشهد مع الزمن.
تبرز Alibaba الحفاظ على مظهر الشخصية، والاتساق البصري، وسلاسة الحركة، والجمع بين الصورة والصوت. وتشمل المجالات المعلنة أيضًا ثبات الكتابات والخامات. تتعلق هذه الخصائص بالتصميم المقصود للنموذج، ولا تعني الحفاظ الحرفي على كل بكسل في جميع الإطارات المُولَّدة.
يستخدم هذا الوضع صورة ابتدائية واحدة. وهي تحدد المشهد الأصلي، وليست مجموعة عينات مستقلة لتكوين جديد. لم تُعلن إمكانية تحديد إطار ختامي منفصل لهذا الإصدار بعينه.
تُقبل JPEG وJPG وPNG وWEBP. يجب ألا يقل طول أي جانب من الصورة المدخلة عن 300 بكسل؛ ونسبة الأبعاد المسموح بها من 1:2,5 إلى 2,5:1، وحجم الملف حتى 20 ميغابايت. تتبع نسبة أبعاد الفيديو الناتج الإطار الأول.
تُختار المدة بعدد صحيح من 3 إلى 15 ثانية. تتوفر مستويات الدقة 480P و720P و1080P؛ وصيغة الإخراج MP4 بمعدل 24 إطارًا في الثانية. يُدعم إنشاء صوت مصاحب مع الفيديو.
يمكن كتابة الوصف بأي لغة، بحد أقصى 5000 حرف غير صيني أو 2500 حرف صيني. إذا تجاوز النص الحد، يُحذف الجزء الزائد، لذا ينبغي صياغة الحركات المهمة وخصائصها ضمن حجم الطلب. قد تعطي بذرة العشوائية الابتدائية نفسها فيديوهات متشابهة، لكنها لا تضمن تطابقها إطارًا بإطار.
POST /v1/videos/generationstext, imagevideo| الحقل | النوع | المتطلب | القيم والحدود | القيمة الافتراضية |
|---|---|---|---|---|
الحقلmodel | النوعstring | المتطلبمطلوب | القيم والحدود happyhorse-1.1-i2v | القيمة الافتراضية— |
الحقلprompt | النوعstring | المتطلباختياري | القيم والحدود الحد الأدنى للطول: 1 | القيمة الافتراضية— |
الحقلduration | النوعinteger | المتطلباختياري | القيم والحدود الحد الأدنى: 3 الحد الأقصى: 15 الوحدة: ثوانٍ | القيمة الافتراضية5 |
الحقلresolution | النوعstring | المتطلباختياري | القيم والحدود 480P, 720P, 1080P | القيمة الافتراضية720P |
الحقلratio | النوعstring | المتطلبغير مدعوم | القيم والحدود | القيمة الافتراضية— |
الحقلimage_urls | النوعhttps_url|data_image_url[] | المتطلبمطلوب | القيم والحدود الحد الأدنى للعناصر: 1 الحد الأقصى للعناصر: 1 الحد الأقصى للبايتات بعد فك الترميز: 20,971,520 أنواع MIME: image/jpeg, image/png, image/webp | القيمة الافتراضية— |
first_frame_to_video · مطلوب: image_urls
| المعلمة | المواصفات |
|---|---|
المعلمةcontent_type | المواصفاتapplication/json |
المعلمةrequired | المواصفاتmodel, image_urls |
المعلمةmaterial_types | المواصفاتtext, image |
المعلمةoptional | المواصفاتduration, resolution, ratio, prompt |
المعلمةduration_integer_range | المواصفات3, 15 |
المعلمةdefault_duration | المواصفات5 |
المعلمةresolution | المواصفات480P, 720P, 1080P |
المعلمةdefault_resolution | المواصفات720P |
المعلمةratio | المواصفات |
المعلمةratio_must_omit | المواصفاتtrue |
المعلمةimage_urls | المواصفات{"min_count":1,"max_count":1,"schemes":["https","بيانات صور نقطية بترميز base64"],"max_data_image_bytes":20971520} |
دورة الحياة: 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
بُنى الطرق ومعرّفاتها دقيقة؛ قدرة المورد منفصلة عن السماح بالطلب.
POST /v1/videos/generationsتحجز Ailoot مبلغًا تقديريًا قبل الطلب. وبعد ظهور النتيجة، تُسوّي الرسوم النهائية بناءً على الاستخدام المقاس. وتستخدم تسوية البث سجل الاستخدام النهائي. كيفية عمل حجز المبلغ وتسوية الرسوم →
set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\n: "${AILOOT_IMAGE_URL:?Set the HTTPS URL of your actual first-frame image}"\nexport AILOOT_IMAGE_URL\npython3 - <<'PY_REQUEST'\nimport json,os\nfrom pathlib import Path\np=json.loads('{"model": "happyhorse-1.1-i2v", "prompt": "The subject walks slowly toward the camera.", "duration": 5, "resolution": "720P"}')\nfrom urllib.parse import urlsplit\nu=os.environ["AILOOT_IMAGE_URL"]\nz=urlsplit(u)\nif z.scheme!="https" or not z.netloc or z.username or z.password:raise SystemExit("Set the actual HTTPS image URL")\np["image_urls"]=[u]\nPath("request.json").write_text(json.dumps(p,ensure_ascii=False))\nPY_REQUEST\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/videos/generations \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \\\n --data-binary @request.json -D response-headers.txt -o result.json\npython3 - <<'PY_RESULT'\nimport json\nfrom pathlib import Path\nr=json.loads(Path("result.json").read_text())\nprint(json.dumps(r))\nPY_RESULT\nmp4
GET /v1/videos/{request_id}GET /v1/videos/generations/{request_id}GET /v1/videos/{request_id}/contentGET /v1/videos/generations/{request_id}/contentset -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\n: "${AILOOT_OPERATION_ID:?Set the actual Ailoot operation ID returned by creation}"\nexport AILOOT_OPERATION_ID\noperation_id=$(python3 -c 'import os,urllib.parse;print(urllib.parse.quote(os.environ["AILOOT_OPERATION_ID"],safe=""))')\ncurl --fail-with-body --silent --show-error "https://api.ailoot.ai/v1/videos/generations/$operation_id" \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -o status.json\npython3 - <<'PY_STATUS'\nimport json\nfrom pathlib import Path\nr=json.loads(Path("status.json").read_text())\nprint(json.dumps(r))\nif r.get("status")=="completed":\n for x in r.get("data",[]):print(x)\nPY_STATUS\nset -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\n: "${AILOOT_STATUS_FILE:?Set the actual completed status JSON file}"\nexport AILOOT_STATUS_FILE\npython3 - <<'PY_REQUEST'\nimport json,os\nfrom pathlib import Path\nfrom urllib.parse import urlsplit,urljoin\nf=Path(os.environ["AILOOT_STATUS_FILE"])\nif not f.is_file():raise SystemExit("Choose the actual completed status file")\nr=json.loads(f.read_text())\nif r.get("status")!="completed" or not isinstance(r.get("data"),list) or not r["data"]:raise SystemExit("Wait for a completed status with asset paths")\nurls=[]\nfor x in r["data"]:\n if not isinstance(x,str) or "\\n" in x or "\\r" in x:raise SystemExit("Invalid asset path")\n u=urljoin("https://api.ailoot.ai",x)\n z=urlsplit(u)\n if z.scheme!="https" or z.netloc!="api.ailoot.ai" or z.username or z.password:raise SystemExit("Use the actual Ailoot asset paths from status")\n urls.append(u)\nPath("asset-urls.txt").write_text("\\n".join(urls)+"\\n")\nPY_REQUEST\nindex=0\nwhile IFS= read -r asset_url; do\n curl --fail-with-body --silent --show-error "$asset_url" \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -o "video-${index}.mp4"\n index=$((index + 1))\ndone < asset-urls.txt\nset -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\n: "${AILOOT_OPERATION_ID:?Set the actual Ailoot operation ID returned by creation}"\nexport AILOOT_OPERATION_ID\noperation_id=$(python3 -c 'import os,urllib.parse;print(urllib.parse.quote(os.environ["AILOOT_OPERATION_ID"],safe=""))')\ncurl --fail-with-body --silent --show-error "https://api.ailoot.ai/v1/videos/generations/$operation_id/content" \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -o video.mp4\nاحفظ كل فيديو مكتمل أو ملف مُرجع؛ ونزّل كل أصل من URL الخاص به الذي تم إرجاعه فعليًا.
احتفظ بكل عنصر بيانات أو فهرس مخرج مُعاد. يشير content_url إلى الأول فقط؛ اجلب كل مسار محتوى أو أصل فعلي. لا يعيد طلب GET للمحتوى دون index جميع المخرجات.
اقرأ المهمة الأصلية الموجودة؛ ولا تعِد إرسال طلب مجهول النتيجة مطلقاً.
| الحقل | النوع |
|---|---|
الحقلid | النوعstring |
الحقلobject | النوعstring |
الحقلmodel | النوعstring |
الحقلstatus | النوعstring |
الحقلcontent_url | النوعsigned URL |
الحقلdata[] | النوعsigned URL |
الحقلusage | النوعobject |
الحقلresult_pending_check | النوعboolean |
| الاستجابة | الشرط | الخطوة التالية |
|---|---|---|
الاستجابة400 · invalid_request_error | الشرطحقول مطلوبة أو تمثيل مادة أو قيمة معلمة غير صحيحة | الخطوة التاليةصحّح الحقول المحددة قبل طلب إنشاء جديد. |
الاستجابة409 · video_not_ready | الشرطمحتوى النتيجة الأصلية غير متاح بعد | الخطوة التاليةاستعلم دورياً باستخدام المعرّف الأصلي المُعاد والتزم بـRetry-After. |
الاستجابةserver_error | الشرطتشير الاستجابة المُعادة إلى أن العملية أو النتيجة تتطلب التحقق | الخطوة التاليةاحتفظ بمعرّف العملية أو المهمة الأصلي المُعاد، وبترويسات الطلب وبالاستجابة؛ وواصل عمليات القراءة المدعومة لتلك العملية الأصلية. لا تُعِد إرسال طلب الإنشاء. |
Ailoot happyhorse-1.1-i2v, happyhorse-i2v, happyhorse-i2v-latest
استخدم مسارات الطرائق المعروضة أعلاه.
happyhorse-i2vنموذج لتحريك الصور: تحدد الصورة الأصلية الإطار الأول، بينما يوجّه الوصف الحركة اللاحقة. ينشئ فيديو قصيرًا مع إمكانية إرفاق صوت.
يغطي هذا الوصف قدرات النموذج. وترد أدناه المدخلات والمخرجات والخيارات المتاحة في Ailoot للطريقة المحددة.
HappyHorse-1.1-I2V هو نموذج من Alibaba يبدأ مشهد الفيديو بصورة جاهزة. تصبح الصورة الإطار الأول، ويمكن للنص تحديد ما يحدث بعده: حركة الشخصية، والتغيّرات في المشهد، واتجاه الكاميرا. يناسب ذلك تحريك رسم توضيحي أو صورة منتج أو تصور بصري مُعدّ مسبقًا.
الوصف النصي اختياري. إذا لم يُقدَّم، يستنتج النموذج الحركة الممكنة من محتوى الصورة الابتدائية. وعند تحديد الطلب صراحةً، تحدد الصورة الأصلية التكوين ومظهر العناصر، بينما توجّه الكلمات تطوّر المشهد مع الزمن.
تبرز Alibaba الحفاظ على مظهر الشخصية، والاتساق البصري، وسلاسة الحركة، والجمع بين الصورة والصوت. وتشمل المجالات المعلنة أيضًا ثبات الكتابات والخامات. تتعلق هذه الخصائص بالتصميم المقصود للنموذج، ولا تعني الحفاظ الحرفي على كل بكسل في جميع الإطارات المُولَّدة.
يستخدم هذا الوضع صورة ابتدائية واحدة. وهي تحدد المشهد الأصلي، وليست مجموعة عينات مستقلة لتكوين جديد. لم تُعلن إمكانية تحديد إطار ختامي منفصل لهذا الإصدار بعينه.
تُقبل JPEG وJPG وPNG وWEBP. يجب ألا يقل طول أي جانب من الصورة المدخلة عن 300 بكسل؛ ونسبة الأبعاد المسموح بها من 1:2,5 إلى 2,5:1، وحجم الملف حتى 20 ميغابايت. تتبع نسبة أبعاد الفيديو الناتج الإطار الأول.
تُختار المدة بعدد صحيح من 3 إلى 15 ثانية. تتوفر مستويات الدقة 480P و720P و1080P؛ وصيغة الإخراج MP4 بمعدل 24 إطارًا في الثانية. يُدعم إنشاء صوت مصاحب مع الفيديو.
يمكن كتابة الوصف بأي لغة، بحد أقصى 5000 حرف غير صيني أو 2500 حرف صيني. إذا تجاوز النص الحد، يُحذف الجزء الزائد، لذا ينبغي صياغة الحركات المهمة وخصائصها ضمن حجم الطلب. قد تعطي بذرة العشوائية الابتدائية نفسها فيديوهات متشابهة، لكنها لا تضمن تطابقها إطارًا بإطار.
POST /v1/videos/generationstext, imagevideo| الحقل | النوع | المتطلب | القيم والحدود | القيمة الافتراضية |
|---|---|---|---|---|
الحقلmodel | النوعstring | المتطلبمطلوب | القيم والحدود happyhorse-i2v | القيمة الافتراضية— |
الحقلprompt | النوعstring | المتطلباختياري | القيم والحدود الحد الأدنى للطول: 1 | القيمة الافتراضية— |
الحقلduration | النوعinteger | المتطلباختياري | القيم والحدود الحد الأدنى: 3 الحد الأقصى: 15 الوحدة: ثوانٍ | القيمة الافتراضية5 |
الحقلresolution | النوعstring | المتطلباختياري | القيم والحدود 480P, 720P, 1080P | القيمة الافتراضية720P |
الحقلratio | النوعstring | المتطلبغير مدعوم | القيم والحدود | القيمة الافتراضية— |
الحقلimage_urls | النوعhttps_url|data_image_url[] | المتطلبمطلوب | القيم والحدود الحد الأدنى للعناصر: 1 الحد الأقصى للعناصر: 1 الحد الأقصى للبايتات بعد فك الترميز: 20,971,520 أنواع MIME: image/jpeg, image/png, image/webp | القيمة الافتراضية— |
first_frame_to_video · مطلوب: image_urls
| المعلمة | المواصفات |
|---|---|
المعلمةmaterial_types | المواصفاتtext, image |
المعلمةrequired | المواصفاتnull |
المعلمةoptional_controls | المواصفاتnull |
دورة الحياة: 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
بُنى الطرق ومعرّفاتها دقيقة؛ قدرة المورد منفصلة عن السماح بالطلب.
POST /v1/videos/generationsتحجز Ailoot مبلغًا تقديريًا قبل الطلب. وبعد ظهور النتيجة، تُسوّي الرسوم النهائية بناءً على الاستخدام المقاس. وتستخدم تسوية البث سجل الاستخدام النهائي. كيفية عمل حجز المبلغ وتسوية الرسوم →
set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\n: "${AILOOT_IMAGE_URL:?Set the HTTPS URL of your actual first-frame image}"\nexport AILOOT_IMAGE_URL\npython3 - <<'PY_REQUEST'\nimport json,os\nfrom pathlib import Path\np=json.loads('{"model": "happyhorse-i2v", "prompt": "The subject walks slowly toward the camera.", "duration": 5, "resolution": "720P"}')\nfrom urllib.parse import urlsplit\nu=os.environ["AILOOT_IMAGE_URL"]\nz=urlsplit(u)\nif z.scheme!="https" or not z.netloc or z.username or z.password:raise SystemExit("Set the actual HTTPS image URL")\np["image_urls"]=[u]\nPath("request.json").write_text(json.dumps(p,ensure_ascii=False))\nPY_REQUEST\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/videos/generations \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \\\n --data-binary @request.json -D response-headers.txt -o result.json\npython3 - <<'PY_RESULT'\nimport json\nfrom pathlib import Path\nr=json.loads(Path("result.json").read_text())\nprint(json.dumps(r))\nPY_RESULT\nmp4
GET /v1/videos/{request_id}GET /v1/videos/generations/{request_id}GET /v1/videos/{request_id}/contentGET /v1/videos/generations/{request_id}/contentset -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\n: "${AILOOT_OPERATION_ID:?Set the actual Ailoot operation ID returned by creation}"\nexport AILOOT_OPERATION_ID\noperation_id=$(python3 -c 'import os,urllib.parse;print(urllib.parse.quote(os.environ["AILOOT_OPERATION_ID"],safe=""))')\ncurl --fail-with-body --silent --show-error "https://api.ailoot.ai/v1/videos/generations/$operation_id" \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -o status.json\npython3 - <<'PY_STATUS'\nimport json\nfrom pathlib import Path\nr=json.loads(Path("status.json").read_text())\nprint(json.dumps(r))\nif r.get("status")=="completed":\n for x in r.get("data",[]):print(x)\nPY_STATUS\nset -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\n: "${AILOOT_STATUS_FILE:?Set the actual completed status JSON file}"\nexport AILOOT_STATUS_FILE\npython3 - <<'PY_REQUEST'\nimport json,os\nfrom pathlib import Path\nfrom urllib.parse import urlsplit,urljoin\nf=Path(os.environ["AILOOT_STATUS_FILE"])\nif not f.is_file():raise SystemExit("Choose the actual completed status file")\nr=json.loads(f.read_text())\nif r.get("status")!="completed" or not isinstance(r.get("data"),list) or not r["data"]:raise SystemExit("Wait for a completed status with asset paths")\nurls=[]\nfor x in r["data"]:\n if not isinstance(x,str) or "\\n" in x or "\\r" in x:raise SystemExit("Invalid asset path")\n u=urljoin("https://api.ailoot.ai",x)\n z=urlsplit(u)\n if z.scheme!="https" or z.netloc!="api.ailoot.ai" or z.username or z.password:raise SystemExit("Use the actual Ailoot asset paths from status")\n urls.append(u)\nPath("asset-urls.txt").write_text("\\n".join(urls)+"\\n")\nPY_REQUEST\nindex=0\nwhile IFS= read -r asset_url; do\n curl --fail-with-body --silent --show-error "$asset_url" \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -o "video-${index}.mp4"\n index=$((index + 1))\ndone < asset-urls.txt\nset -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\n: "${AILOOT_OPERATION_ID:?Set the actual Ailoot operation ID returned by creation}"\nexport AILOOT_OPERATION_ID\noperation_id=$(python3 -c 'import os,urllib.parse;print(urllib.parse.quote(os.environ["AILOOT_OPERATION_ID"],safe=""))')\ncurl --fail-with-body --silent --show-error "https://api.ailoot.ai/v1/videos/generations/$operation_id/content" \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -o video.mp4\nاحفظ كل فيديو مكتمل أو ملف مُرجع؛ ونزّل كل أصل من URL الخاص به الذي تم إرجاعه فعليًا.
احتفظ بكل عنصر بيانات أو فهرس مخرج مُعاد. يشير content_url إلى الأول فقط؛ اجلب كل مسار محتوى أو أصل فعلي. لا يعيد طلب GET للمحتوى دون index جميع المخرجات.
اقرأ المهمة الأصلية الموجودة؛ ولا تعِد إرسال طلب مجهول النتيجة مطلقاً.
| الحقل | النوع |
|---|---|
الحقلid | النوعstring |
الحقلobject | النوعstring |
الحقلmodel | النوعstring |
الحقلstatus | النوعstring |
الحقلcontent_url | النوعsigned URL |
الحقلdata[] | النوعsigned URL |
الحقلusage | النوعobject |
الحقلresult_pending_check | النوعboolean |
| الاستجابة | الشرط | الخطوة التالية |
|---|---|---|
الاستجابة400 · invalid_request_error | الشرطحقول مطلوبة أو تمثيل مادة أو قيمة معلمة غير صحيحة | الخطوة التاليةصحّح الحقول المحددة قبل طلب إنشاء جديد. |
الاستجابة409 · video_not_ready | الشرطمحتوى النتيجة الأصلية غير متاح بعد | الخطوة التاليةاستعلم دورياً باستخدام المعرّف الأصلي المُعاد والتزم بـRetry-After. |
الاستجابةserver_error | الشرطتشير الاستجابة المُعادة إلى أن العملية أو النتيجة تتطلب التحقق | الخطوة التاليةاحتفظ بمعرّف العملية أو المهمة الأصلي المُعاد، وبترويسات الطلب وبالاستجابة؛ وواصل عمليات القراءة المدعومة لتلك العملية الأصلية. لا تُعِد إرسال طلب الإنشاء. |
Ailoot happyhorse-1.1-i2v, happyhorse-i2v, happyhorse-i2v-latest
استخدم مسارات الطرائق المعروضة أعلاه.
happyhorse-i2v-latestنموذج لتحريك الصور: تحدد الصورة الأصلية الإطار الأول، بينما يوجّه الوصف الحركة اللاحقة. ينشئ فيديو قصيرًا مع إمكانية إرفاق صوت.
يغطي هذا الوصف قدرات النموذج. وترد أدناه المدخلات والمخرجات والخيارات المتاحة في Ailoot للطريقة المحددة.
HappyHorse-1.1-I2V هو نموذج من Alibaba يبدأ مشهد الفيديو بصورة جاهزة. تصبح الصورة الإطار الأول، ويمكن للنص تحديد ما يحدث بعده: حركة الشخصية، والتغيّرات في المشهد، واتجاه الكاميرا. يناسب ذلك تحريك رسم توضيحي أو صورة منتج أو تصور بصري مُعدّ مسبقًا.
الوصف النصي اختياري. إذا لم يُقدَّم، يستنتج النموذج الحركة الممكنة من محتوى الصورة الابتدائية. وعند تحديد الطلب صراحةً، تحدد الصورة الأصلية التكوين ومظهر العناصر، بينما توجّه الكلمات تطوّر المشهد مع الزمن.
تبرز Alibaba الحفاظ على مظهر الشخصية، والاتساق البصري، وسلاسة الحركة، والجمع بين الصورة والصوت. وتشمل المجالات المعلنة أيضًا ثبات الكتابات والخامات. تتعلق هذه الخصائص بالتصميم المقصود للنموذج، ولا تعني الحفاظ الحرفي على كل بكسل في جميع الإطارات المُولَّدة.
يستخدم هذا الوضع صورة ابتدائية واحدة. وهي تحدد المشهد الأصلي، وليست مجموعة عينات مستقلة لتكوين جديد. لم تُعلن إمكانية تحديد إطار ختامي منفصل لهذا الإصدار بعينه.
تُقبل JPEG وJPG وPNG وWEBP. يجب ألا يقل طول أي جانب من الصورة المدخلة عن 300 بكسل؛ ونسبة الأبعاد المسموح بها من 1:2,5 إلى 2,5:1، وحجم الملف حتى 20 ميغابايت. تتبع نسبة أبعاد الفيديو الناتج الإطار الأول.
تُختار المدة بعدد صحيح من 3 إلى 15 ثانية. تتوفر مستويات الدقة 480P و720P و1080P؛ وصيغة الإخراج MP4 بمعدل 24 إطارًا في الثانية. يُدعم إنشاء صوت مصاحب مع الفيديو.
يمكن كتابة الوصف بأي لغة، بحد أقصى 5000 حرف غير صيني أو 2500 حرف صيني. إذا تجاوز النص الحد، يُحذف الجزء الزائد، لذا ينبغي صياغة الحركات المهمة وخصائصها ضمن حجم الطلب. قد تعطي بذرة العشوائية الابتدائية نفسها فيديوهات متشابهة، لكنها لا تضمن تطابقها إطارًا بإطار.
POST /v1/videos/generationstext, imagevideo| الحقل | النوع | المتطلب | القيم والحدود | القيمة الافتراضية |
|---|---|---|---|---|
الحقلmodel | النوعstring | المتطلبمطلوب | القيم والحدود happyhorse-i2v-latest | القيمة الافتراضية— |
الحقلprompt | النوعstring | المتطلباختياري | القيم والحدود الحد الأدنى للطول: 1 | القيمة الافتراضية— |
الحقلduration | النوعinteger | المتطلباختياري | القيم والحدود الحد الأدنى: 3 الحد الأقصى: 15 الوحدة: ثوانٍ | القيمة الافتراضية5 |
الحقلresolution | النوعstring | المتطلباختياري | القيم والحدود 480P, 720P, 1080P | القيمة الافتراضية720P |
الحقلratio | النوعstring | المتطلبغير مدعوم | القيم والحدود | القيمة الافتراضية— |
الحقلimage_urls | النوعhttps_url|data_image_url[] | المتطلبمطلوب | القيم والحدود الحد الأدنى للعناصر: 1 الحد الأقصى للعناصر: 1 الحد الأقصى للبايتات بعد فك الترميز: 20,971,520 أنواع MIME: image/jpeg, image/png, image/webp | القيمة الافتراضية— |
first_frame_to_video · مطلوب: image_urls
| المعلمة | المواصفات |
|---|---|
المعلمةmaterial_types | المواصفاتtext, image |
المعلمةrequired | المواصفاتnull |
المعلمةoptional_controls | المواصفاتnull |
دورة الحياة: 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
بُنى الطرق ومعرّفاتها دقيقة؛ قدرة المورد منفصلة عن السماح بالطلب.
POST /v1/videos/generationsتحجز Ailoot مبلغًا تقديريًا قبل الطلب. وبعد ظهور النتيجة، تُسوّي الرسوم النهائية بناءً على الاستخدام المقاس. وتستخدم تسوية البث سجل الاستخدام النهائي. كيفية عمل حجز المبلغ وتسوية الرسوم →
set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\n: "${AILOOT_IMAGE_URL:?Set the HTTPS URL of your actual first-frame image}"\nexport AILOOT_IMAGE_URL\npython3 - <<'PY_REQUEST'\nimport json,os\nfrom pathlib import Path\np=json.loads('{"model": "happyhorse-i2v-latest", "prompt": "The subject walks slowly toward the camera.", "duration": 5, "resolution": "720P"}')\nfrom urllib.parse import urlsplit\nu=os.environ["AILOOT_IMAGE_URL"]\nz=urlsplit(u)\nif z.scheme!="https" or not z.netloc or z.username or z.password:raise SystemExit("Set the actual HTTPS image URL")\np["image_urls"]=[u]\nPath("request.json").write_text(json.dumps(p,ensure_ascii=False))\nPY_REQUEST\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/videos/generations \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \\\n --data-binary @request.json -D response-headers.txt -o result.json\npython3 - <<'PY_RESULT'\nimport json\nfrom pathlib import Path\nr=json.loads(Path("result.json").read_text())\nprint(json.dumps(r))\nPY_RESULT\nmp4
GET /v1/videos/{request_id}GET /v1/videos/generations/{request_id}GET /v1/videos/{request_id}/contentGET /v1/videos/generations/{request_id}/contentset -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\n: "${AILOOT_OPERATION_ID:?Set the actual Ailoot operation ID returned by creation}"\nexport AILOOT_OPERATION_ID\noperation_id=$(python3 -c 'import os,urllib.parse;print(urllib.parse.quote(os.environ["AILOOT_OPERATION_ID"],safe=""))')\ncurl --fail-with-body --silent --show-error "https://api.ailoot.ai/v1/videos/generations/$operation_id" \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -o status.json\npython3 - <<'PY_STATUS'\nimport json\nfrom pathlib import Path\nr=json.loads(Path("status.json").read_text())\nprint(json.dumps(r))\nif r.get("status")=="completed":\n for x in r.get("data",[]):print(x)\nPY_STATUS\nset -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\n: "${AILOOT_STATUS_FILE:?Set the actual completed status JSON file}"\nexport AILOOT_STATUS_FILE\npython3 - <<'PY_REQUEST'\nimport json,os\nfrom pathlib import Path\nfrom urllib.parse import urlsplit,urljoin\nf=Path(os.environ["AILOOT_STATUS_FILE"])\nif not f.is_file():raise SystemExit("Choose the actual completed status file")\nr=json.loads(f.read_text())\nif r.get("status")!="completed" or not isinstance(r.get("data"),list) or not r["data"]:raise SystemExit("Wait for a completed status with asset paths")\nurls=[]\nfor x in r["data"]:\n if not isinstance(x,str) or "\\n" in x or "\\r" in x:raise SystemExit("Invalid asset path")\n u=urljoin("https://api.ailoot.ai",x)\n z=urlsplit(u)\n if z.scheme!="https" or z.netloc!="api.ailoot.ai" or z.username or z.password:raise SystemExit("Use the actual Ailoot asset paths from status")\n urls.append(u)\nPath("asset-urls.txt").write_text("\\n".join(urls)+"\\n")\nPY_REQUEST\nindex=0\nwhile IFS= read -r asset_url; do\n curl --fail-with-body --silent --show-error "$asset_url" \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -o "video-${index}.mp4"\n index=$((index + 1))\ndone < asset-urls.txt\nset -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\n: "${AILOOT_OPERATION_ID:?Set the actual Ailoot operation ID returned by creation}"\nexport AILOOT_OPERATION_ID\noperation_id=$(python3 -c 'import os,urllib.parse;print(urllib.parse.quote(os.environ["AILOOT_OPERATION_ID"],safe=""))')\ncurl --fail-with-body --silent --show-error "https://api.ailoot.ai/v1/videos/generations/$operation_id/content" \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -o video.mp4\nاحفظ كل فيديو مكتمل أو ملف مُرجع؛ ونزّل كل أصل من URL الخاص به الذي تم إرجاعه فعليًا.
احتفظ بكل عنصر بيانات أو فهرس مخرج مُعاد. يشير content_url إلى الأول فقط؛ اجلب كل مسار محتوى أو أصل فعلي. لا يعيد طلب GET للمحتوى دون index جميع المخرجات.
اقرأ المهمة الأصلية الموجودة؛ ولا تعِد إرسال طلب مجهول النتيجة مطلقاً.
| الحقل | النوع |
|---|---|
الحقلid | النوعstring |
الحقلobject | النوعstring |
الحقلmodel | النوعstring |
الحقلstatus | النوعstring |
الحقلcontent_url | النوعsigned URL |
الحقلdata[] | النوعsigned URL |
الحقلusage | النوعobject |
الحقلresult_pending_check | النوعboolean |
| الاستجابة | الشرط | الخطوة التالية |
|---|---|---|
الاستجابة400 · invalid_request_error | الشرطحقول مطلوبة أو تمثيل مادة أو قيمة معلمة غير صحيحة | الخطوة التاليةصحّح الحقول المحددة قبل طلب إنشاء جديد. |
الاستجابة409 · video_not_ready | الشرطمحتوى النتيجة الأصلية غير متاح بعد | الخطوة التاليةاستعلم دورياً باستخدام المعرّف الأصلي المُعاد والتزم بـRetry-After. |
الاستجابةserver_error | الشرطتشير الاستجابة المُعادة إلى أن العملية أو النتيجة تتطلب التحقق | الخطوة التاليةاحتفظ بمعرّف العملية أو المهمة الأصلي المُعاد، وبترويسات الطلب وبالاستجابة؛ وواصل عمليات القراءة المدعومة لتلك العملية الأصلية. لا تُعِد إرسال طلب الإنشاء. |
Ailoot happyhorse-1.1-i2v, happyhorse-i2v, happyhorse-i2v-latest
استخدم مسارات الطرائق المعروضة أعلاه.