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\nAlibaba מדגישה שמירה על מראה הדמות, עקביות חזותית, תנועה חלקה ושילוב תמונה וצליל. בין הכיוונים המוצהרים נכללת גם יציבות של כיתובים ומרקמים. תכונות אלה מתייחסות לתכנון המודל ואינן מבטיחות שמירה מילולית על כל פיקסל בכל הפריימים שנוצרו.\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": "eb79ccc48c3fb31aa95898f53771ea2b735524bae9674043cfeaee8603f5e365", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "he", "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
השתמשו בנתיבי השיטות המוצגים למעלה.