HeyGen: HeyGen Video
HeyGen Video יוצר סצנות של 5–15 שניות עם דיאלוג, אווירה ואפקטים מטקסט, מתמונה ראשונה או מדוגמאות חזותיות ושמע. המודל הכללי שלו heygen-video-1 תומך בשוטים של מוצרים ודמויות, עם בקרות ייחוס ופלט MP4. פעולות ברורות ומוגדרות היטב מעניקות לו בריף הפקה שימושי.
על המודל
התיאור הזה מציג את יכולות המודל. הקלט, הפלט והאפשרויות הזמינים ב-Ailoot מפורטים בהמשך לפי השיטה שנבחרה.
HeyGen Video הוא מודל יצירת הסצנות הכללי של HeyGen, המזוהה אצל היצרן כ־heygen-video-1. הוא יוצר את הנושא, הסביבה, האור והצליל יחד מתוך בריף יצירתי. כל קטע באורך 5–15 שניות ומכיל את רצועת השמע שנוצרה לו, לרבות דיאלוג, אווירה ואפקטים. קלטי הפקה שימושיים כוללים תיאור סצנה, תצלום מוצר או חומר הקובע אדם, מקום או תנועה. הנכס המתקבל הוא סצנה קצרה להצגת מוצר, לקטע שילוב בתהליך היכרות, למבט על נכס או לעבודת וידאו ערוכה אחרת.
שלושה מצבים מעניקים לקלטים תפקידים שונים. טקסט־לווידאו יוצר סצנה מההנחיה. תמונה־לווידאו מתחיל ממש בתמונה שסופקה, ואז עוקב אחר בריף הפעולה. ייחוס־לווידאו משתמש בתמונות, בווידאו ובשמע אופציונלי שסופקו כדי להנחות סצנה חדשה, ודורש לפחות תמונת ייחוס אחת או סרטון ייחוס אחד. בחרו תמונת פריים ראשון כאשר קומפוזיציית הפתיחה חייבת להתאים לתמונת סטילס, או דוגמאות כאשר חפץ מוכר צריך להופיע בקומפוזיציה אחרת. מודל סצנות זה נפרד ממנועי רינדור האווטארים של HeyGen ומתהליך הקומפוזיציה Video Agent.
מדריך היצרן מעדיף הוראות שוט מפורטות וקונקרטיות: נושא אחד, מקום אחד ופעולה תחומה אחת, עם מצלמה נעולה או נעה בעדינות. תארו את מיקום המצלמה, העדשה או כוונת עומק השדה, האור, טקסטורת המשטחים וטיפול הצבע. הסבירו היכן חפצים נוגעים כאשר הפעולה תלויה במגע. בדוגמת מוצר מקורית, השתמשו בתצלום ייחוס של תרמוס ובקשו שיעמוד על דלפק עץ בזמן שמגיש מדבר לצדו, עם תנועת מצלמה קטנה לעבר התרמוס. בדקו בתוצאה את צורת התרמוס, מיקומו וסימוניו הנראים.
רשימות הייחוס תומכות בעד תשע תמונות, שלושה סרטונים ושלושה פריטי שמע, עם מקסימום של שנים עשר פריטי ייחוס בסך הכול. תמונות, סרטונים ושמע ממוספרים בנפרד בפורמט ההנחיה של היצרן: התמונה הראשונה היא <Picture 1> והסרטון הראשון הוא <Video 1>. תנו לכל דוגמה תפקיד וזהו אותו במפורש בבריף. המודל קורא את חמש השניות הראשונות מכל סרטון ייחוס, ולכן הכינו את המקטע הרלוונטי בתחילתו. תיעוד ה־API קובע גם יחסי ממדים לסרטוני ייחוס בין 1:4 ל־4:1. קטע ארוך המכיל את התנועה הרצויה רק בסופו הוא הכנה גרועה לחלון הקלט הזה בן חמש השניות.
ממשק הייחוס המתועד מקבל משאב HTTPS נגיש ישירות, מזהה נכס שהועלה או base64 מוטמע. המדריך מפרט גודלי תמונה מרביים של 16 MB באמצעות כתובת ו־5 MB בהטמעה; וידאו או שמע יכולים להיות עד 32 MB באמצעות כתובת ו־16 MB בהטמעה. הכינו חומר מקור ברור שבו קל להבחין בנושא החשוב וללא הוראות מתחרות בדוגמאות שונות. שמרו על הכיוון המיועד בתמונת הפריים הראשון. פרטי הקלט האלה נוגעים לתהליך הייחוס של היצרן ומסייעים לארגן את החומרים היצירתיים למצב שנבחר.
הנחו צליל באותו בריף כמו התמונה. ציינו דיאלוג, הגשה קולית, צליל חדר ואפקטים מסוימים, לרבות אם צליל צריך להיות קרוב או רחוק. ציינו את הטיפול המוזיקלי המיועד כאשר הסצנה צריכה להכיל רק דיבור ואווירה. המדריך מציע להקצות בערך 2.5 מילים מדוברות לשנייה כאומדן תכנון, ולכן השאירו מקום להפסקות ולפעולה הנראית. אפשר לתכנן פתיחה קצרה כשורה אחת ואחריה רגע החושף את המוצר. האזינו למילים בפועל ולמידת התאמת הצליל שנוצר למרחב ולפעולה.
משך הפלט נבחר בשניות שלמות מחמש עד חמש עשרה, עם ברירת מחדל של חמש שניות. הרזולוציה היא מחלקת גודל: 480p, 768p, 1080p או 2k. בחירות המסגור המתועדות הן 21:9, 16:9, 4:3, 1:1, 3:4 ו־9:16. בטקסט־לווידאו ובייחוס־לווידאו ב־1080p או 2k, בחרו 16:9 או 9:16; מסגור ייחוס מסתגל מתועד ב־480p וב־768p. תמונה־לווידאו עוקב אחר יחסי הממדים של התמונה הראשונה, ולכן חתכו לפני היצירה כאשר הצורה הנדרשת משתנה. בדקו את ממדי התוצאה שהושלמה בפועל במקום להניח שתווית מחלקת גודל מרמזת על זוג פיקסלים מקובל אחד.
מדריך המודל קובע וידאו MP4 עם קידוד תמונה H.264 ושמע AAC בסטריאו ב־32 kHz. יצירה מעובדת אסינכרונית, והמשימה שהושלמה מספקת את מיקום הסרטון הניתן לנגינה, משכו וממדיו. אפשר לרענן את מיקום הסרטון החתום באמצעות אחזור המשימה שוב. שמרו את הקטע עצמו, חומרי הייחוס והבריף לבדיקת עריכה. רשומה ממתינה או בעיבוד עוקבת אחר היצירה; הסרטון שהושלם הוא תוצר ההפקה שיש להעריך מבחינת תמונה, דיבור וצליל.
היצרן מתעד אפשרויות שיפור הנחיה turbo, quality ו־disabled; disabled שומר על הנוסח המוכן כפי שנכתב. seed קבוע שימושי בהשוואת שינוי בסעיף אחד תוך שימור יתר הקלטים. רשמו את ה־seed ואת ההגדרות שנבחרו לצד בריף השוט. בכיתוב על המסך, שמרו על ביטוי מיועד קצר ואייתו אותו במדויק; המדריך ממליץ להרכיב פסקאות, אותיות קטנות ותרשימים מסומנים לאחר מכן. בדקו כל תו נראה בכותרת שנוצרה במקום להניח שהנוסח שוחזר נכון.
המדריך מזהה טקסט ארוך על המסך, תנועה אורגנית רכה כגון עלי כותרת, נייר או שיער, ופעולות ידיים מקרוב כתחומים אמינים פחות. בהסבר תהליכי, תנו לשורה כתובה בבירור להעביר את השלבים בעוד התמונה מציגה אדם או חפץ יציבים; השתמשו בחומרים חזותיים שנבדקו בנפרד כאשר הפעולה הפיזית עצמה חייבת להיות מדויקת. בדקו את השוט כולו מבחינת המשכיות חפצים, מגע, פרטי פנים וידיים, דיאלוג וצליל. רשימה תמציתית של מה שצריך להשתנות בביצוע הבא שומרת על בריף הפקה מפורט כמעשי.
Ailoot Ultra · וידאו POST /v1/videos heygen/heygen-video-1
heygen/heygen-video-1התחלה
HeyGen Video יוצר סצנות של 5–15 שניות עם דיאלוג, אווירה ואפקטים מטקסט, מתמונה ראשונה או מדוגמאות חזותיות ושמע. המודל הכללי שלו heygen-video-1 תומך בשוטים של מוצרים ודמויות, עם בקרות ייחוס ופלט MP4. פעולות ברורות ומוגדרות היטב מעניקות לו בריף הפקה שימושי.
- סוגי קלט נתמכים
- טקסט · תמונות · שמע · וידאו
- תוצאות
- וידאו
זמין ב-Ailoot · קלט ושיטות
Ailoot Ultra · וידאו POST /v1/videos
- סוגי קלט
text,image,audio,video- סוגי פלט
video- פורמט פלט
- הבתים המקוריים של MP4; ללא נרמול או המרת קידוד
| שדה | סוג | דרישה | ערכים ומגבלות | ברירת מחדל |
|---|---|---|---|---|
שדהmodel | סוגstring | דרישהחובה | ערכים ומגבלות heygen/heygen-video-1 | ברירת מחדל— |
שדהprompt | סוגstring | דרישהחובה | ערכים ומגבלות | ברירת מחדל— |
שדהduration | סוגinteger | דרישהחובה | ערכים ומגבלות 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 מינימום: 1 מקסימום: 600 | ברירת מחדל— |
שדהresolution | סוגstring | דרישהרשות | ערכים ומגבלות 480p, 768p, 2K | ברירת מחדל— |
שדהaspect_ratio | סוגstring | דרישהרשות | ערכים ומגבלות 21:9, 16:9, 4:3, 1:1, 3:4, 9:16 | ברירת מחדל— |
שדהgenerate_audio | סוגboolean | דרישהרשות | ערכים ומגבלות false | ברירת מחדל— |
שדהframe_images | סוגarray | דרישהרשות | ערכים ומגבלות מספר פריטים מזערי: 1 מספר פריטים מרבי: 1 תוכן הקלט: מערך אובייקטים של פריימים. כל אובייקט כולל type=image_url, שדה image_url המכיל url, ו־frame_type. יש להשתמש בכתובת URL של תמונה ב־HTTPS ולהגדיר frame_type לערך first_frame. כל תפקיד של פריים מופיע פעם אחת לכל היותר. מפתחות מדויקים: type, image_url, frame_type תנאים: המפתחות האלה מתארים כל אובייקט פריים; image_url מכיל רק url. יש להשמיט frame_images בבקשה המבוססת על טקסט בלבד. | ברירת מחדל— |
שדהinput_references | סוגarray | דרישהרשות | ערכים ומגבלות | ברירת מחדל— |
שדהseed | סוגinteger | דרישהרשות | ערכים ומגבלות מינימום: -9,223,372,036,854,775,808 מקסימום: 9,223,372,036,854,775,807 | ברירת מחדל— |
שדהcallback_url | סוגstring | דרישהרשות | ערכים ומגבלות תבנית: ^https:// | ברירת מחדל— |
שדהsession_id | סוגstring | דרישהרשות | ערכים ומגבלות | ברירת מחדל— |
שדהtrace | סוגobject | דרישהרשות | ערכים ומגבלות | ברירת מחדל— |
שדהuser | סוגstring | דרישהרשות | ערכים ומגבלות | ברירת מחדל— |
שילובים של חומרי קלט
מטקסט לווידאו · הנחיה כתובה. · נדרש: model, prompt, duration
יש לספק prompt כטקסט ו־duration בשניות שלמות. יש לבחור רזולוציה נתמכת ובמידת הצורך גם יחס גובה־רוחב.
model: סוג: string · heygen/heygen-video-1
prompt: סוג: string · מספר בייטים מרבי ב-UTF-8: 10,000 · נדרשים תווים שאינם רווחים: כן
מתמונה לווידאו · הנחיה כתובה ותמונה של הפריים הראשון. · נדרש: model, prompt, duration, frame_images
frame_images הוא מערך. כל אובייקט פריים כולל type, image_url ו־frame_type; השדה image_url מכיל url. יש להגדיר type לערך image_url. יש להשתמש ב־first_frame. כל תפקיד של פריים מופיע פעם אחת לכל היותר. יש לספק כתובת URL ציבורית של תמונה ב־HTTPS לכל פריים. יש לבחור רזולוציה נתמכת ובמידת הצורך גם יחס גובה־רוחב.
המפתחות המדויקים: type, image_url, frame_type
model: סוג: string · heygen/heygen-video-1
prompt: סוג: string · מספר בייטים מרבי ב-UTF-8: 10,000 · נדרשים תווים שאינם רווחים: כן
Reference to video · הנחיה כתובה וחומרי עזר נתמכים מסוג תמונה, וידאו ואודיו. · נדרש: model, prompt, duration, input_references
input_references הוא מערך אובייקטים. יש להגדיר type לערך image_url, video_url, audio_url ולהשתמש בשדה המתאים המכיל url. יש להשתמש בכתובות HTTPS ציבוריות. יש להשמיט frame_images כדי לבחור מצב חומרי עזר. יש לבחור רזולוציה נתמכת ובמידת הצורך גם יחס גובה־רוחב.
model: סוג: string · heygen/heygen-video-1
prompt: סוג: string · מספר בייטים מרבי ב-UTF-8: 10,000 · נדרשים תווים שאינם רווחים: כן
פרמטרים ומחזור חיים של השיטה
| פרמטר | מפרט |
|---|---|
פרמטרcontent_type | מפרטapplication/json |
פרמטרrequired | מפרטmodel, prompt, duration |
פרמטרmaterial_types | מפרטtext, image, audio, video |
פרמטרadditional_properties | מפרטfalse |
פרמטרoptional_controls | מפרטresolution, aspect_ratio, generate_audio, frame_images, input_references, seed, callback_url, session_id, trace, user |
מחזור חיים: submit_once_poll_original
GET /v1/videos/{public_id}
GET /v1/videos/{public_id}/content
תעריפים
אופן חישוב החיוב הסופי
התעריפים המוצגים מספקים אומדן לעלות לפני היצירה. החיוב הסופי מחושב לפי העלות שנרשמה עבור היצירה המקורית. משך הפלט שנמדד והכמויות החזויות אינם הכמות הסופית לחיוב.
מידע תעריפים אינו מוסיף אפשרויות לבקשה. הפרמטרים הנתמכים מפורטים בשיטה שנבחרה.
- מצב מהיר
- לא צוין כאשר נבחר מצב מהיר
- מצב Flex
- לא צוין כאשר נבחר מצב flex
- מאמץ חשיבה מרבי
- לא צוין כאשר מאמץ החשיבה המרבי משתמש בהתאמת ברירת המחדל (default)
תעריפים משוערים להשוואה
מחירים לפי תצורה
התאימו כל חיוב לתנאים המוצגים. השתמשו בתעריף אחד לכל קבוצה של תצורות חלופיות.
| תצורה | טבלת תעריפים | כמות חזויה | יחידת חיוב | תנאי חיוב | חיוב |
|---|---|---|---|---|---|
| תצורהתעריפי בסיס לטוקנים | טבלת תעריפיםתעריף בסיס | כמות חזויה— | יחידת חיוב— | תנאי חיוב— | חיוב קלט · טוקני קלט · אומדן להשוואה בלבד — / 1K טוקנים פלט · טוקני פלט · אומדן להשוואה בלבד — / 1K טוקנים קלט · קריאה מהמטמון · אומדן להשוואה בלבד — / 1K טוקנים קלט · כתיבה למטמון · אומדן להשוואה בלבד — / 1K טוקנים קלט · כתיבה למטמון, 1 שעה · אומדן להשוואה בלבד — / 1K טוקנים |
| תצורהמחיר וידאו | טבלת תעריפים— | כמות חזויה— | יחידת חיובלכל שניית וידאו | תנאי חיובresolution: 2k | חיוב פלט · מחיר וידאו · אומדן להשוואה בלבד $0.2 לכל שניית וידאו |
| תצורהמחיר וידאו | טבלת תעריפים— | כמות חזויה— | יחידת חיובלכל שניית וידאו | תנאי חיובresolution: 480p | חיוב פלט · מחיר וידאו · אומדן להשוואה בלבד $0.04 לכל שניית וידאו |
| תצורהמחיר וידאו | טבלת תעריפים— | כמות חזויה— | יחידת חיובלכל שניית וידאו | תנאי חיובresolution: 768p | חיוב פלט · מחיר וידאו · אומדן להשוואה בלבד $0.072 לכל שניית וידאו |
| תצורהמחיר וידאו | טבלת תעריפים— | כמות חזויה— | יחידת חיובלכל שניית וידאו | תנאי חיובמצב יצירה: reference; רזולוציה: 2k | חיוב פלט · מחיר וידאו · אומדן להשוואה בלבד $0.36 לכל שניית וידאו |
| תצורהמחיר וידאו | טבלת תעריפים— | כמות חזויה— | יחידת חיובלכל שניית וידאו | תנאי חיובמצב יצירה: reference; רזולוציה: 480p | חיוב פלט · מחיר וידאו · אומדן להשוואה בלבד $0.14 לכל שניית וידאו |
| תצורהמחיר וידאו | טבלת תעריפים— | כמות חזויה— | יחידת חיובלכל שניית וידאו | תנאי חיובמצב יצירה: reference; רזולוציה: 768p | חיוב פלט · מחיר וידאו · אומדן להשוואה בלבד $0.2 לכל שניית וידאו |
| תצורהתמונת ייחוס בקלט | טבלת תעריפים— | כמות חזויה— | יחידת חיובלכל תמונת קלט לייחוס | תנאי חיוב— | חיוב קלט · תמונת ייחוס בקלט · אומדן להשוואה בלבד $0.08 לכל תמונת קלט לייחוס |
| תצורהעלות יצירה משוערת | טבלת תעריפים— | כמות חזויהאומדן ליצירה אחת | יחידת חיוב— | תנאי חיוב— | חיוב פלט · עלות יצירה משוערת · אומדן להשוואה בלבד $0.2 אומדן לפני היצירה אומדן זה אינו חיוב נוסף או תעריף קבוע עבור היצירה שהושלמה. |
לפני הבקשה Ailoot משריינת סכום משוער. לאחר קבלת התוצאה היא מסדירה את החיוב הסופי לפי השימוש המדוד. הסדרת חיוב בהזרמה משתמשת ברשומת השימוש הסופית. איך פועלים שריון הסכום והסדרת החיוב →
פרטי תעריף הייחוס
טבלאות הייחוס ברמת המודל אינן משנות את בחירת השיטה, הצעות המחיר או החיובים. החיובים בפועל משתמשים בתעריפי שיטת Ailoot שנבחרה.
הפניות למחירי תצורות וידאו
מחירים לפי תצורה
התאימו כל חיוב לתנאים המוצגים. השתמשו בתעריף אחד לכל קבוצה של תצורות חלופיות.
| תצורה | תנאי חיוב | חיוב |
|---|---|---|
| תצורהמחיר וידאו | תנאי חיובresolution: 2k | חיוב פלט · מחיר וידאו $0.18 לכל שניית וידאו מחיר הייחוס שפורסם עבור התצורה המוצגת. החיובים הסופיים נקבעים לפי התצורה שחויבה בפועל. |
| תצורהמחיר וידאו | תנאי חיובresolution: 480p | חיוב פלט · מחיר וידאו $0.04 לכל שניית וידאו מחיר הייחוס שפורסם עבור התצורה המוצגת. החיובים הסופיים נקבעים לפי התצורה שחויבה בפועל. |
| תצורהמחיר וידאו | תנאי חיובresolution: 768p | חיוב פלט · מחיר וידאו $0.06 לכל שניית וידאו מחיר הייחוס שפורסם עבור התצורה המוצגת. החיובים הסופיים נקבעים לפי התצורה שחויבה בפועל. |
| תצורהמחיר וידאו | תנאי חיובמצב יצירה: reference; רזולוציה: 2k | חיוב פלט · מחיר וידאו $0.36 לכל שניית וידאו מחיר הייחוס שפורסם עבור התצורה המוצגת. החיובים הסופיים נקבעים לפי התצורה שחויבה בפועל. |
| תצורהמחיר וידאו | תנאי חיובמצב יצירה: reference; רזולוציה: 480p | חיוב פלט · מחיר וידאו $0.08 לכל שניית וידאו מחיר הייחוס שפורסם עבור התצורה המוצגת. החיובים הסופיים נקבעים לפי התצורה שחויבה בפועל. |
| תצורהמחיר וידאו | תנאי חיובמצב יצירה: reference; רזולוציה: 768p | חיוב פלט · מחיר וידאו $0.12 לכל שניית וידאו מחיר הייחוס שפורסם עבור התצורה המוצגת. החיובים הסופיים נקבעים לפי התצורה שחויבה בפועל. |
דוגמאות לבקשות
Ailoot Ultra · וידאו
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
python3 - <<'PY_REQUEST'
from pathlib import Path
Path('request.json').write_text('{"aspect_ratio":"16:9","duration":8,"model":"heygen/heygen-video-1","prompt":"A serene mountain landscape at sunset","resolution":"480p"}', 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 result.json
python3 - <<'PY_RESULT'
import json
from pathlib import Path
r=json.loads(Path('result.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
קבלה ושמירה של תוצאות
Ailoot Ultra · וידאו
כתובות חתומות לתוכן שבבעלותכם
GET /v1/videos/{public_id}GET /v1/videos/{public_id}/content
בדיקת מצב המשימה
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 שהוחזר בפועל.
יש לשמור כל פלט ממשי שבבעלותכם ואת המטא־נתונים המדודים שהוחזרו איתו.
כשצריך לבדוק את התגובה המקורית
503 result_pending_check + originalid + X-Should-Retry:false; אין לשלוח שוב את הבקשה המקורית
שדות התגובה
| שדה | סוג | משמעות |
|---|---|---|
שדהindex | סוגinteger | משמעותמיקום הווידאו הזה ברשימת הפלטים, בספירה המתחילה מאפס. |
שדהcontent_url | סוגstring | משמעותכתובת URL חתומה להורדת הווידאו שהושלם ב־HTTPS. |
שדהsha256 | סוגstring | null | משמעותתקציר SHA-256 של בתי הווידאו המקורי; null אם אינו זמין. |
שדהsize_bytes | סוגinteger | null | משמעותגודל קובץ הווידאו המקורי בבתים; null אם אינו זמין. |
שדהduration_ms | סוגinteger | null | משמעותמשך הווידאו המדוד באלפיות שנייה; null אם אינו זמין. |
שדהwidth | סוגinteger | null | משמעותרוחב הווידאו בפיקסלים; null אם אינו זמין. |
שדהheight | סוגinteger | null | משמעותגובה הווידאו בפיקסלים; null אם אינו זמין. |
שדהvideo_codec | סוגstring | null | משמעותמזהה מקודד הווידאו; null אם לא נרשם. |
שדהhas_audio | סוגboolean | null | משמעותהאם הווידאו מכיל רצועת אודיו; null אם לא נמדד. |
שדהaudio_codec | סוגstring | null | משמעותמזהה מקודד האודיו; null כאשר לא נרשם מזהה. |
שגיאות והשלבים הבאים
| תגובה | תנאי | השלב הבא |
|---|---|---|
תגובה404 · not_found_error | תנאיהגישה לווידאו אינה זמינה, או שמזהה הווידאו הזה לא נמצא. | השלב הבאיש לבדוק את הגישה לווידאו. עבור וידאו קיים, יש להשתמש במזהה הציבורי המקורי שלו ובאותו מפתח API. |
תגובה401 · authentication_error | תנאימפתח ה־API אינו תואם לחשבון המאומת. | השלב הבאיש לבדוק את מפתח ה־API ואת הגישה לחשבון לפני השליחה. |
תגובה400 · invalid_request_error | תנאילא ניתן היה לקרוא את הבקשה, או שאינדקס ההורדה אינו תקף. | השלב הבאיש לתקן את גוף הבקשה. להורדה, יש לבחור אינדקס פלט שהוחזר על ידי המשימה המקורית. |
תגובה422 · price_unavailable | תנאילא ניתן לתמחר את תצורת הווידאו שנבחרה. | השלב הבאיש לבחור תצורת וידאו נתמכת ולהשלים את האפשרויות הנדרשות בה לפני שליחת בקשה מתוקנת. |
תגובה422 · invalid_request_error | תנאיקלט וידאו או משימת המשך מקורית אינם תקפים. | השלב הבאיש להשתמש בקלטי HTTPS תקפים. להמשך, יש להשתמש במזהה הציבורי של הווידאו המקורי שלכם שהושלם, עם אותו מפתח API. |
תגובה402 · billing_error | תנאיהיתרה הזמינה או המגבלות אינן מאפשרות לשריין סכום. | השלב הבאיש לבדוק את היתרה הזמינה ואת המגבלות לפני שליחת בקשה חדשה. |
תגובה503 · server_error | תנאיאימות הווידאו, האחסון או הגישה לשירות אינם זמינים זמנית. | השלב הבאיש להמתין לזמינות השירות. אם כבר יש לכם מזהה וידאו, יש לבדוק את המשימה המקורית הזו במקום ליצור וידאו נוסף. |
תגובה503 · result_pending_check | תנאייש לבדוק את תוצאת הווידאו המקורית ואת החיוב. | השלב הבאיש לשמור את מזהה הווידאו שהוחזר ולבדוק את המשימה הזו. אין לשלוח בקשת יצירה חלופית בזמן הבדיקה. |
תגובה503 · owned_result_unavailable | תנאיהורדת הווידאו הקיים אינה זמינה זמנית. | השלב הבאיש לבדוק את אותה משימת וידאו בהמשך ולהוריד את הפלט הקיים שלה. יצירה חדשה יוצרת פעולה נפרדת. |
תגובה409 · video_not_ready | תנאיתוכן הווידאו לא פורסם. | השלב הבאיש לבדוק את הסטטוס של המשימה המקורית. יש להוריד לאחר שהיא מדווחת completed; אם היא מדווחת failed, יש לפעול לפי ההודעה שלה על בדיקת החיוב. |
כינויים
כינויים למודל
Ailoot Ultra heygen/heygen-video-1
כינויים לנתיבי שיטות
השתמשו בנתיבי השיטות המוצגים למעלה.
מזהי מודלים קשורים IDs
FAQ · HeyGen: HeyGen Video
- אילו קלטים ותוצאות זמינים?
POST /v1/videos·heygen/heygen-video-1:text,image,audio,video→video- באילו שדות הבקשה משתמשת?
POST /v1/videos·heygen/heygen-video-1:model,prompt,duration,resolution,aspect_ratio,generate_audio,frame_images,input_references,seed,callback_url,session_id,trace,user- אילו מגבלות חלות?
POST /v1/videos·heygen/heygen-video-1:duration.minimum:1;duration.maximum:600;frame_images.max_items:1;frame_images.min_items:1;seed.minimum:-9223372036854775808;seed.maximum:9223372036854775807