Source: https://ailoot.ai/models/he/heygen-heygen-video-1/
Canonical: https://ailoot.ai/models/he/heygen-heygen-video-1/
Language: he

# HeyGen: HeyGen Video

[Markdown](https://ailoot.ai/models/he/heygen-heygen-video-1/index.md) · [JSON](https://ailoot.ai/models/he/heygen-heygen-video-1/facts.json)

## [HeyGen: HeyGen Video](https://ailoot.ai/models/he/heygen-heygen-video-1/)

HeyGen Video יוצר סצנות של 5–15 שניות עם דיאלוג, אווירה ואפקטים מטקסט, מתמונה ראשונה או מדוגמאות חזותיות ושמע. המודל הכללי שלו heygen-video-1 תומך בשוטים של מוצרים ודמויות, עם בקרות ייחוס ופלט MP4. פעולות ברורות ומוגדרות היטב מעניקות לו בריף הפקה שימושי.

- [**Ailoot Ultra · וידאו** `POST /v1/videos` `heygen/heygen-video-1`](https://ailoot.ai/models/he/heygen-heygen-video-1/#method-0)

על המודל

התיאור הזה מציג את יכולות המודל. הקלט, הפלט והאפשרויות הזמינים ב-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`](https://ailoot.ai/models/he/#m=heygen%2Fheygen-video-1&route=Ultra&caller=heygen%2Fheygen-video-1&fmt=videos)

HeyGen /`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 משריינת סכום משוער. לאחר קבלת התוצאה היא מסדירה את החיוב הסופי לפי השימוש המדוד. הסדרת חיוב בהזרמה משתמשת ברשומת השימוש הסופית. [איך פועלים שריון הסכום והסדרת החיוב →](https://ailoot.ai/docs/he/billing/reserve/)

#### פרטי תעריף הייחוס

טבלאות הייחוס ברמת המודל אינן משנות את בחירת השיטה, הצעות המחיר או החיובים. החיובים בפועל משתמשים בתעריפי שיטת 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 · וידאו

curl · צרו סרטון

```bash
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`

##### בדיקת מצב המשימה

GET · אחזור מצב הפעולה המקורית

```bash
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
```

קריאות תוכן נוספות

שמירת כל הפלטים שהושלמו ובבעלותכם

```bash
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`](https://ailoot.ai/models/he/#m=heygen%2Fheygen-video-1&route=Ultra&caller=heygen%2Fheygen-video-1&fmt=videos)

#### כינויים לנתיבי שיטות

השתמשו בנתיבי השיטות המוצגים למעלה.

#### מזהי מודלים קשורים IDs

[`heygen/heygen-video-1`](https://ailoot.ai/models/he/#m=heygen%2Fheygen-video-1&route=Ultra&caller=heygen%2Fheygen-video-1&fmt=videos)

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`

חברו Ailoot ל- Claude Code, OpenCode, Hermes או ליישום שלכם.

## החברה ופורטפוליו הפרויקטים שלה

החברה ופורטפוליו הפרויקטים שלה: מיליוני לקוחות; מכירות בהיקף של מיליארדים מדי חודש.

## קנו אסימונים בהנחה.

הנחת מנוי לעבודה קבועה. קודי הנחה עד 50% על רכישת אסימונים.

מנוי

בחרו מסלול עם הנחה לבקשות הקבועות שלכם.

קוד הנחה עד 50%

הזינו קוד ברכישה. המחיר יחושב מחדש לפי המבצע הפעיל.

הוצאות בהיסטוריה

המודל, האסימונים והסכום נשמרים לכל בקשה.

[בחירת מנוי](https://ailoot.ai/docs/he/billing/subscriptions/) · [מחירי מודלים](https://ailoot.ai/models/he/)

## חברו API למוצר שאתם מוכרים.

SaaS, יישומים ובוטים לפי ההצעה והסכם הרישוי של Ailoot. למכירה מחדש בקשו רישיון משווק.

יישום מסחרי

שלבו יצירת טקסט, תמונות, וידאו ושמע בתכונות בתשלום של השירות שלכם.

רישיון למכירה מחדש

שלחו תיאור פרויקט ואופן מתן גישה. בקשו תנאי שימוש ומכירה מחדש בכתב.

מסמכים באתר

ההצעה, הסכם הרישוי ומדיניות עיבוד הנתונים זמינים לפני החיבור.

[בקשת רישיון למכירה מחדש](mailto:support@ailoot.ai) · [ההצעה והסכם הרישוי](https://ailoot.ai/legal/offer?lang=he)

## Ailoot · החברה ופורטפוליו הפרויקטים שלה





Ailoot נשענת על ניסיון תפעולי מצטבר, בסיס לקוחות רחב, שירות יציב ובקרה שוטפת של KPI.





החברה ופורטפוליו הפרויקטים שלה: מיליוני לקוחות; מכירות בהיקף של מיליארדים מדי חודש.





Ailoot משתמשת בניסיון התפעולי הזה כדי לספק גישת API ליכולות AI במוצרי לקוחות, בסוכנים, באפליקציות ובאוטומציות.