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; יצירה מפריים ראשון עוקבת אחר תמונת הקלט. בחרו את המבנה לפי היעד והשאירו מקום לכיתובים או לרכיבי פריסה בהמשך. בדקו את המסגור בפועל של הסרטון שהוחזר בגודל התצוגה המיועד.

הפלט של משפחת המודלים כולל קול. תנו לביצוע או לאווירה תפקיד ברור בבריף, ובדקו כל דיאלוג, אפקט או ערוץ רקע יחד עם התמונה. שמרו על תוכן מדובר קצר מספיק כדי להשאיר מקום לפעולה ולהפסקות, במקום לדחוס תסריט ארוך לשוט קצר אחד. כאשר יש דיבור, בדקו תנועות שפתיים, שיוך לדובר ואת הניסוח בפועל. קבלת שפה בהנחיה אינה מגדירה כשלעצמה הגייה מובטחת או קלט נפרד של ייחוס קולי.

תהליך העבודה המתועד של היצרן הוא אסינכרוני: מזהה משימה עוקב אחר העיבוד, ותוצאה מוצלחת מספקת את מיקום הווידאו. לקישור התוצאה ולשאילתות המשימה מתועד תוקף של עשרים וארבע שעות. שמרו את הקליפ שהושלם, את הייחוסים ואת ההנחיה כרשומת התיקונים. המדריכים מתעדים גם בקרות seed וסימן מים. ערך seed קבוע יכול לסייע בהשוואה, אך היצרן אומר במפורש שהוא אינו מבטיח תוצאות זהות, לכן שפטו את התוצר שהוחזר במקום להניח שהגדרה אחת מקבעת כל פריים.

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: לא צוין כאשר נבחר מצב 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