HeyGen: Avatar IV
Avatar IV מנפיש תמונה לסרטון מדבר מסונכרן לשפתיים, עם הבעות פנים ותזמון מחוות המונחים על ידי הקול. HeyGen מתעדת תהליכי תסריט או שמע מוקלט ובקרות תנועה של Photo Avatar למגישים מציאותיים או מסוגננים.
על המודל
התיאור הזה מציג את יכולות המודל. הקלט, הפלט והאפשרויות הזמינים ב-Ailoot מפורטים בהמשך לפי השיטה שנבחרה.
Avatar IV הוא מנוע האווטארים של HeyGen להפיכת תמונת סטילס לסרטון מדבר עשיר בהבעה. העיצוב שלו, הממיר שמע להבעה בהשראת דיפוזיה, משתמש בטון, בקצב וברגש הקוליים להנחיית תנועות פנים, הטיות ראש, הפסקות ומיקרו־הבעות. מטרתו היא מגיש או דמות המעבירים תוכן מדובר עם סנכרון שפתיים ומחוות, ולא מחולל סצנות כללי היוצר סביבה ופסקול שלמים מהנחיה קולנועית.
היצרן מתאר תמיכה בדמויות מציאותיות ומסוגננות, לרבות תמונות בזווית או בפרופיל, פנים בסגנון אנימה וחיות מחמד. דמויות מבוססות צילום פועלות באופן מיטבי כאשר קל לזהות את עיניהן, פיהן ומבנה פניהן. HeyGen ממליצה על תמונה ברורה ומוארת היטב, עם תנוחה טבעית וידיים נראות כאשר מחוות חשובות. פנים קטנות מאוד, שפתיים מוסתרות, מסכות כבדות, מקור בולט או פרופורציות מוגזמות מאוד עלולים להחליש תנועת פנים וסנכרון שפתיים. התאימו את מסגור המקור לביצוע המיועד.
היצרן מספק שני נתיבי קלט לדיבור. תסריט כתוב משולב בקול שנבחר; רצועת שמע מוקלטת מראש מספקת את הקול ואת התזמון ישירות. השתמשו בנתיב השמע המוקלט כשההגשה כבר נקבעה, ובנתיב התסריט כאשר צריך לסנתז את הדיבור. אלו קלטים חלופיים בממשק המתועד. הכינו את הנוסח הסופי, השמות וההגייה לפני ההנפשה, ושמרו את השמע או התסריט לצד הסרטון שהוחזר כדי שאפשר יהיה לבדוק את תוצאת הדיבור.
פרופיל מודל Avatar IV של HeyGen מכסה אווטארי אולפן, Digital Twins, Photo Avatars, תמונות ישירות ונושאים שנוצרו מהנחיה. Photo Avatar לשימוש חוזר מספק נושא קבוע לסרטונים מאוחרים יותר, ואילו תהליך תמונה ישירה מתחיל מהתמונה שסופקה. פרופיל Photo Avatar של היצרן מציע הוראות תנועה בטקסט חופשי ובחירות הבעה high, medium או low, כאשר low הוא ברירת המחדל. שמרו על מראה האווטאר והמנוע שנבחרו בעת יצירת סדרה, כדי שתמונת מקור או מודל רינדור ששונו לא יהפכו לשינוי בלתי מורגש במגיש.
להנחיית תנועה, תארו פעולת גוף נראית ואת איכותה הרגשית. ״מהנהן בעדינות בחיוך חם״ נותן מחווה אחת והבעה אחת; ברכה קצרה יכולה להשתמש בנפנוף יד ידידותי. היצרן ממליץ על מחווה מרכזית אחת, עם אפשרות לשלב הבעת פנים, ולא יותר משני סעיפים קצרים לרצף. Avatar IV מטפל בקצב מתוך הביצוע, ולכן מדריך Studio אינו דורש לוח מחוות לפי שניות. ניסוח מדויק ותמציתי קל יותר לבדיקה מכמה פעולות מתחרות בהנחיה אחת.
פרופיל השמע־לווידאו של היצרן מרנדר עד שלושים דקות שמע שסופק לכל בקשה, ולנכסי MP3 או WAV המועלים יש מגבלה של 32 MB. לשיעור או להקלטה ארוכים יותר, חלקו את החומר בגבולות דיבור מגובשים ושמרו על הסדר המקורי. תזמון הדיבור בסרטון הסופי צריך לעקוב אחר השמע שנבחר, ולא אחר אומדן בלתי קשור למשך קטע.
הגדרות הפלט המתועדות של היצרן כוללות 720p או 1080p וצורות 16:9, 9:16, 4:5, 5:4 או 1:1, עם אפשרות אוטומטית העוקבת אחר יחסי הממדים של המקור. התאמת cover יכולה לחתוך את הנושא; contain מכילה את הנושא כולו ועשויה להשאיר רקע מסביב נראה. תהליך השמע־לווידאו שלו מחזיר MP4 כברירת מחדל. באווטארי וידאו, פלט WebM שקוף דורש תמיכה בהפרדת רקע, והיצרן מחיל הסרת רקע לפלט הזה במקום לשלבו עם רקע חדש. בדקו את המסגור ואת הקובץ בפועל לפני הצבת המגיש בקומפוזיציה גדולה יותר.
פתיחת הדרכה יכולה להשתמש בתמונת מגיש ברורה, בהסבר תמציתי ובמחווה מאופקת אחת בהוראה המרכזית. הסבר מוצר יכול לשמר אותו מראה אווטאר תוך שינוי התסריט המדובר למאפיינים שונים. היצרן מתעד גם קובצי כתוביות אופציונליים וכתוביות צרובות; בדקו את הנוסח והתזמון שלהן לצד הדיבור. הרינדור אסינכרוני בממשק היצרן, ולכן תגובת יצירה והסרטון שהושלם הם תוצרים שונים. שמרו את ההקלטה המוגמרת ואת מצב ההשלמה שלה לצד תוצאת המשימה.
Avatar IV נשאר נפרד מהתנועה מונחית הייחוס של Avatar V ומבקרות ה־Studio המוגדרות מראש הנפרדות שלו. הוא נפרד גם מיצירת הסצנות הכללית של HeyGen Video ומשיחת אווטאר חיה אינטראקטיבית. בדקו את תנועת הפה שרונדרה, הידיים הנראות, הבעות הפנים, ההפסקות והנוסח המדובר מול חומר המקור והטון המיועד. התמונה, התנוחה, התאורה והוראות התנועה משפיעות על התוצאה; יש לבדוק הנפשה מבוססת צילום כביצוע שנוצר, תוך שימור הקלטים שנבחרו לשינויים מאוחרים.
Ailoot Ultra · וידאו POST /v1/videos heygen/avatar-iv
heygen/avatar-ivהתחלה
Avatar IV מנפיש תמונה לסרטון מדבר מסונכרן לשפתיים, עם הבעות פנים ותזמון מחוות המונחים על ידי הקול. HeyGen מתעדת תהליכי תסריט או שמע מוקלט ובקרות תנועה של Photo Avatar למגישים מציאותיים או מסוגננים.
- סוגי קלט נתמכים
- טקסט · תמונות · שמע · וידאו
- תוצאות
- וידאו
זמין ב-Ailoot · קלט ושיטות
Ailoot Ultra · וידאו POST /v1/videos
- סוגי קלט
text,image,audio,video- סוגי פלט
video
| שדה | סוג | דרישה | ערכים ומגבלות | ברירת מחדל |
|---|---|---|---|---|
שדהmodel | סוגstring | דרישהחובה | ערכים ומגבלות heygen/avatar-iv | ברירת מחדל— |
שדהinput_references | סוגarray | דרישהחובה | ערכים ומגבלות מספר פריטים מזערי: 2 מספר פריטים מרבי: 2 | ברירת מחדל— |
שדהprompt | סוגstring | דרישהרשות | ערכים ומגבלות | ברירת מחדל— |
פרמטרים ומחזור חיים של השיטה
| פרמטר | מפרט |
|---|---|
פרמטרcontent_type | מפרטapplication/json |
פרמטרrequired | מפרטmodel, input_references |
פרמטרmaterial_types | מפרטtext, image, audio, video |
פרמטרmaterial_conditions | מפרטיש להשתמש בכתובות תוכן של נכסי מדיה ממשיים שהושלמו ונמצאים בבעלותכם, עם החתימות שהוחזרו: מקור וידאו אחד עבור BFL, או מקור תמונה אחד ומקור אודיו אחד עבור אווטאר. נדרשת ראיה מהמקור לבעלות, לסוג ולבתים., יש לספק בדיוק תמונת PNG/JPEG אחת ונכס אודיו WAV/MP3 אחד. גודל האודיו הוא לכל היותר 32000000 בתים, ומשכו גדול מ־0 ולכל היותר 1800 שניות. |
מחזור חיים: asynchronous_job_then_owned_outputs
GET /v1/videos/{request_id} · id או polling_url שהוחזרו בפועל
GET /v1/videos/{request_id}/content
תעריפים
אופן חישוב החיוב הסופי
התעריפים המוצגים מספקים אומדן לעלות לפני היצירה. החיוב הסופי מחושב לפי העלות שנרשמה עבור היצירה המקורית. משך הפלט שנמדד והכמויות החזויות אינם הכמות הסופית לחיוב.
מידע תעריפים אינו מוסיף אפשרויות לבקשה. הפרמטרים הנתמכים מפורטים בשיטה שנבחרה.
- מצב מהיר
- לא צוין כאשר נבחר מצב מהיר
- מצב Flex
- לא צוין כאשר נבחר מצב flex
- מאמץ חשיבה מרבי
- לא צוין כאשר מאמץ החשיבה המרבי משתמש בהתאמת ברירת המחדל (default)
תעריפים משוערים להשוואה
מחירים לפי תצורה
התאימו כל חיוב לתנאים המוצגים. השתמשו בתעריף אחד לכל קבוצה של תצורות חלופיות.
| תצורה | טבלת תעריפים | כמות חזויה | יחידת חיוב | תנאי חיוב | חיוב |
|---|---|---|---|---|---|
| תצורהתעריפי בסיס לטוקנים | טבלת תעריפיםתעריף בסיס | כמות חזויה— | יחידת חיוב— | תנאי חיוב— | חיוב קלט · טוקני קלט · אומדן להשוואה בלבד — / 1K טוקנים פלט · טוקני פלט · אומדן להשוואה בלבד — / 1K טוקנים קלט · קריאה מהמטמון · אומדן להשוואה בלבד — / 1K טוקנים קלט · כתיבה למטמון · אומדן להשוואה בלבד — / 1K טוקנים קלט · כתיבה למטמון, 1 שעה · אומדן להשוואה בלבד — / 1K טוקנים |
| תצורהמחיר וידאו | טבלת תעריפים— | כמות חזויה— | יחידת חיובלכל שניית וידאו | תנאי חיובלא הוגדר תנאי נוסף במפתח תמחור זה. | חיוב פלט · מחיר וידאו · אומדן להשוואה בלבד $0.1 לכל שניית וידאו |
| תצורהעלות יצירה משוערת | טבלת תעריפים— | כמות חזויהאומדן ליצירה אחת | יחידת חיוב— | תנאי חיוב— | חיוב פלט · עלות יצירה משוערת · אומדן להשוואה בלבד $0.1 אומדן לפני היצירה אומדן זה אינו חיוב נוסף או תעריף קבוע עבור היצירה שהושלמה. |
לפני הבקשה Ailoot משריינת סכום משוער. לאחר קבלת התוצאה היא מסדירה את החיוב הסופי לפי השימוש המדוד. הסדרת חיוב בהזרמה משתמשת ברשומת השימוש הסופית. איך פועלים שריון הסכום והסדרת החיוב →
דוגמאות לבקשות
Ailoot Ultra · וידאו
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
: "${AILOOT_INPUT_REFERENCES_JSON:?Set the actual documented input value}"
export AILOOT_INPUT_REFERENCES_JSON
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
request={'model': 'heygen/avatar-iv', 'input_references': '${ACTUAL_OWNED_INPUT_REFERENCES}'}
request['input_references']=json.loads(os.environ['AILOOT_INPUT_REFERENCES_JSON'])
Path('request.json').write_text(json.dumps(request,ensure_ascii=False),encoding='utf-8')
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 response.bin
# Retain the complete response and headers, every actual output, original returned identifiers and all usage fields. Recover the original operation without submitting creation again.
קבלה ושמירה של תוצאות
Ailoot Ultra · וידאו
GET /v1/videos/{request_id}GET /v1/videos/{request_id}/content
שמירת כל הנכסים שהושלמו
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
: "${AILOOT_STATUS_FILE:?Set the actual completed status JSON file}"
export AILOOT_STATUS_FILE
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
from urllib.parse import urlsplit,urljoin
f=Path(os.environ["AILOOT_STATUS_FILE"])
if not f.is_file():raise SystemExit("Choose the actual completed status file")
r=json.loads(f.read_text())
if 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")
urls=[]
for x in r["data"]:
if not isinstance(x,str) or "\n" in x or "\r" in x:raise SystemExit("Invalid asset path")
u=urljoin("https://api.ailoot.ai",x)
z=urlsplit(u)
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")
urls.append(u)
Path("asset-urls.txt").write_text("\n".join(urls)+"\n")
PY_REQUEST
index=0
while IFS= read -r asset_url; do
curl --fail-with-body --silent --show-error "$asset_url" \
-H "Authorization: Bearer $AILOOT_API_KEY" -o "video-${index}.mp4"
index=$((index + 1))
done < asset-urls.txt
שמירת כל התוצאות שהושלמו
שמרו כל וידאו שהושלם או קובץ שהוחזר; אחזרו כל נכס מכל URL שהוחזר בפועל.
שמרו את התשובה המלאה ואת הכותרות, כל פלט שהתקבל בפועל, את המזהים המקוריים שהוחזרו ואת כל שדות השימוש. שחזרו את הפעולה המקורית בלי לשלוח שוב בקשת יצירה.
כשצריך לבדוק את התגובה המקורית
יש לשמור את X-Client-Request-ID, את X-Ailoot-Task-Id ואת id/polling_url שהוחזרו בפועל. יש להמשיך את המשימה המקורית; אין לשלוח שוב בקשת יצירה.
שדות התגובה
| שדה | סוג |
|---|---|
שדהid | סוג |
שדהstatus | סוג |
שדהdata[] | סוג |
שדהoutputs[] | סוג |
כינויים
כינויים למודל
Ailoot Ultra heygen/avatar-iv
כינויים לנתיבי שיטות
השתמשו בנתיבי השיטות המוצגים למעלה.
מזהי מודלים קשורים IDs
FAQ · HeyGen: Avatar IV
- אילו קלטים ותוצאות זמינים?
POST /v1/videos·heygen/avatar-iv:text,image,audio,video→video- באילו שדות הבקשה משתמשת?
POST /v1/videos·heygen/avatar-iv:model,input_references,prompt