Source: https://ailoot.ai/models/he/kwaivgi-kling-v3-0-pro/
Canonical: https://ailoot.ai/models/he/kwaivgi-kling-v3-0-pro/
Language: he

# Kling: Video v3.0 Pro

[Markdown](https://ailoot.ai/models/he/kwaivgi-kling-v3-0-pro/index.md) · [JSON](https://ailoot.ai/models/he/kwaivgi-kling-v3-0-pro/facts.json)

## [Kling: Video v3.0 Pro](https://ailoot.ai/models/he/kwaivgi-kling-v3-0-pro/)

Kling VIDEO 3.0 Pro הוא פרופיל הווידאו המקצועי 1080p של Kuaishou לסצנות מונחות טקסט ותמונה. הוא משלב קטעים של שלוש עד חמש עשרה שניות, שמע מקורי, פריימי גבול מונחים ובימוי בשוט יחיד או מרובה שוטים לקונספטים קולנועיים ולהפקות קצרות.

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

על המודל

התיאור הזה מציג את יכולות המודל. הקלט, הפלט והאפשרויות הזמינים ב-Ailoot מפורטים בהמשך לפי השיטה שנבחרה.

Kling VIDEO 3.0 Pro הוא הפרופיל המקצועי של מודל VIDEO 3.0 של Kuaishou. מצב Pro המתועד שלו מפיק וידאו ב־1080p מתוך בריף טקסטואלי או סצנה מונחית תמונה, עם קטעים של שלוש עד חמש עשרה שניות. גרסת 3.0 משלבת שמע מקורי, בקרות עקביות נושא ובימוי מרובה שוטים, ונותנת להפקה קצרה דרך ברורה לציין מראה, פעולה, כיסוי מצלמה וצליל.

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

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

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

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

פריימי התחלה וסיום מספקים גבולות חזותיים למעבר מותנה תמונה. הכינו פריימים התואמים זה לזה מבחינת הנושא והסצנה המיועדת, ואז תארו כיצד התנועה מחברת ביניהם. קלט הפריימים הנתמך של היצרן משתמש בתמונות JPG, ‏JPEG או PNG, עם קבצים שאינם גדולים מ־10 MB, ממדים של לפחות 300 פיקסלים ויחס ממדים של תמונת ההתחלה בין 1:2.5 ל־2.5:1. למשימה נשלטת פריימים ולסטוריבורד מותאם יש טיפול קלט משלהם, ולכן ארגנו את החומר לתהליך שנבחר לפני כתיבת הבריף המלא.

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

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

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

פרופיל Pro הוא 1080p; פרופיל Standard הוא 720p. מצב 4K שנבחר בנפרד אצל היצרן הוא פרופיל פלט נוסף, ולכן אין להתייחס ל־Pro כמילה נרדפת לכל הגדרת רזולוציה גבוהה יותר. ביצירה מונחית טקסט, בחירות המסגור המתועדות כוללות 16:9, ‏9:16 ו־1:1. בחרו פריים למיקום המיועד ושמרו על קומפוזיציה קריאה בתוכו.

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

**Ailoot Ultra · וידאו** `POST /v1/videos` `kwaivgi/kling-v3.0-pro`

[`kwaivgi/kling-v3.0-pro`](https://ailoot.ai/models/he/#m=kwaivgi%2Fkling-v3.0-pro&route=Ultra&caller=kwaivgi%2Fkling-v3.0-pro&fmt=videos)

Kuaishou /`kwaivgi/kling-v3.0-pro`

### התחלה

Kling VIDEO 3.0 Pro הוא פרופיל הווידאו המקצועי 1080p של Kuaishou לסצנות מונחות טקסט ותמונה. הוא משלב קטעים של שלוש עד חמש עשרה שניות, שמע מקורי, פריימי גבול מונחים ובימוי בשוט יחיד או מרובה שוטים לקונספטים קולנועיים ולהפקות קצרות.

סוגי קלט נתמכים

טקסט · תמונות

תוצאות

וידאו

### זמין ב-Ailoot · קלט ושיטות

**Ailoot Ultra · וידאו** `POST /v1/videos`

סוגי קלט

`text`, `image`

סוגי פלט

`video`

פורמט פלט

הבתים המקוריים של MP4; ללא נרמול או המרת קידוד

| שדה | סוג | דרישה | ערכים ומגבלות | ברירת מחדל |
| --- | --- | --- | --- | --- |
| שדה`model` | סוג`string` | דרישהחובה | ערכים ומגבלות kwaivgi/kling-v3.0-pro | ברירת מחדל— |
| שדה`prompt` | סוג`string` | דרישהחובה | ערכים ומגבלות | ברירת מחדל— |
| שדה`duration` | סוג`integer` | דרישהחובה | ערכים ומגבלות ⁦3⁩, ⁦4⁩, ⁦5⁩, ⁦6⁩, ⁦7⁩, ⁦8⁩, ⁦9⁩, ⁦10⁩, ⁦11⁩, ⁦12⁩, ⁦13⁩, ⁦14⁩, ⁦15⁩ מינימום: ⁦1⁩ מקסימום: ⁦600⁩ | ברירת מחדל— |
| שדה`resolution` | סוג`string` | דרישהרשות | ערכים ומגבלות 720p | ברירת מחדל— |
| שדה`aspect_ratio` | סוג`string` | דרישהרשות | ערכים ומגבלות 16:9, 9:16, 1:1 | ברירת מחדל— |
| שדה`generate_audio` | סוג`boolean` | דרישהרשות | ערכים ומגבלות false, true תנאים: השמטת האפשרות הזו בוחרת במחיר הכולל אודיו. הגדירו אותה ל־false כדי לבחור במחיר ללא אודיו. יש לבדוק את has\_audio בתוצאה כדי לדעת אם הוחזרה רצועת אודיו. | ברירת מחדל— |
| שדה`frame_images` | סוג`array` | דרישהרשות | ערכים ומגבלות מספר פריטים מזערי: ⁦1⁩ מספר פריטים מרבי: ⁦2⁩ תוכן הקלט: מערך אובייקטים של פריימים. כל אובייקט כולל type=image\_url, שדה image\_url המכיל url, ו־frame\_type. יש להשתמש בכתובת URL של תמונה ב־HTTPS ולהגדיר frame\_type לערך first\_frame או last\_frame. כל תפקיד של פריים מופיע פעם אחת לכל היותר. מפתחות מדויקים: type, image\_url, frame\_type תנאים: המפתחות האלה מתארים כל אובייקט פריים; image\_url מכיל רק url. יש להשמיט frame\_images בבקשה המבוססת על טקסט בלבד. | ברירת מחדל— |
| שדה`input_references` | סוג`array` | דרישהרשות | ערכים ומגבלות | ברירת מחדל— |
| שדה`size` | סוג`string` | דרישהרשות | ערכים ומגבלות 1280x720, 720x1280, 720x720 תבנית: ^\[1-9\]\[0-9\]\*x\[1-9\]\[0-9\]\*$ | ברירת מחדל— |
| שדה`callback_url` | סוג`string` | דרישהרשות | ערכים ומגבלות תבנית: ^https:// | ברירת מחדל— |
| שדה`session_id` | סוג`string` | דרישהרשות | ערכים ומגבלות | ברירת מחדל— |
| שדה`trace` | סוג`object` | דרישהרשות | ערכים ומגבלות | ברירת מחדל— |
| שדה`user` | סוג`string` | דרישהרשות | ערכים ומגבלות | ברירת מחדל— |

שילובים של חומרי קלט

**מטקסט לווידאו** · הנחיה כתובה. · נדרש: model, prompt, duration

`יש לספק prompt כטקסט ו־duration בשניות שלמות. יש לבחור רזולוציה נתמכת; יש להוסיף יחס גובה־רוחב או להשתמש בגודל מהרשימה.`

`model`: סוג: string · kwaivgi/kling-v3.0-pro

`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, עם last_frame אופציונלי. כל תפקיד של פריים מופיע פעם אחת לכל היותר. יש לספק כתובת URL ציבורית של תמונה ב־HTTPS לכל פריים. יש לבחור רזולוציה נתמכת; יש להוסיף יחס גובה־רוחב או להשתמש בגודל מהרשימה.`

המפתחות המדויקים: type, image\_url, frame\_type

`model`: סוג: string · kwaivgi/kling-v3.0-pro

`prompt`: סוג: string · מספר בייטים מרבי ב-UTF-8: ⁦10,000⁩ · נדרשים תווים שאינם רווחים: כן

פרמטרים ומחזור חיים של השיטה

| פרמטר | מפרט |
| --- | --- |
| פרמטר`content_type` | מפרטapplication/json |
| פרמטר`required` | מפרטmodel, prompt, duration |
| פרמטר`material_types` | מפרטtext, image |
| פרמטר`additional_properties` | מפרטfalse |
| פרמטר`optional_controls` | מפרטresolution, aspect\_ratio, generate\_audio, frame\_images, input\_references, size, 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 טוקנים |
| תצורהפלט וידאו · תעריף ייחוס | טבלת תעריפים— | כמות חזויה— | רכיב חיוב`reference_output_rate` | רזולוציית ייחוס— | מצב ייחוס— | שמע ייחוס— | יחידת חיובלכל שניית פלט | תנאי חיוב— | חיוב פלט · תעריף ייחוס לשניית וידאו בפלט · אומדן להשוואה בלבד **$0.224** לכל שניית פלט |
| תצורהמחיר וידאו | טבלת תעריפים— | כמות חזויה— | רכיב חיוב— | רזולוציית ייחוס— | מצב ייחוס— | שמע ייחוס— | יחידת חיובלכל שניית וידאו | תנאי חיובאודיו: with\_audio | חיוב פלט · מחיר וידאו · אומדן להשוואה בלבד **$0.336** לכל שניית וידאו |
| תצורהוידאו מתמונה (תמונות פריימים) · 1080p · תעריף ייחוס | טבלת תעריפים— | כמות חזויה— | רכיב חיוב`reference_output_rate` | רזולוציית ייחוס1080p | מצב ייחוסמתמונות לווידאו (תמונות פריימים) | שמע ייחוסללא שמע | יחידת חיובלכל שניית פלט | תנאי חיוב— | חיוב פלט · תעריף ייחוס לשניית וידאו בפלט · אומדן להשוואה בלבד **$0.224** לכל שניית פלט |
| תצורהמחיר וידאו | טבלת תעריפים— | כמות חזויה— | רכיב חיוב— | רזולוציית ייחוס— | מצב ייחוס— | שמע ייחוס— | יחידת חיובלכל שניית וידאו | תנאי חיובמצב יצירה: image\_to\_video; רזולוציה: 720p | חיוב פלט · מחיר וידאו · אומדן להשוואה בלבד **$0.224** לכל שניית וידאו |
| תצורהוידאו מטקסט · 1080p · תעריף ייחוס | טבלת תעריפים— | כמות חזויה— | רכיב חיוב`reference_output_rate` | רזולוציית ייחוס1080p | מצב ייחוסמטקסט לווידאו | שמע ייחוסללא שמע | יחידת חיובלכל שניית פלט | תנאי חיוב— | חיוב פלט · תעריף ייחוס לשניית וידאו בפלט · אומדן להשוואה בלבד **$0.224** לכל שניית פלט |
| תצורהוידאו מטקסט · 480p · תעריף ייחוס | טבלת תעריפים— | כמות חזויה— | רכיב חיוב`reference_output_rate` | רזולוציית ייחוס480p | מצב ייחוסמטקסט לווידאו | שמע ייחוסללא שמע | יחידת חיובלכל שניית פלט | תנאי חיוב— | חיוב פלט · תעריף ייחוס לשניית וידאו בפלט · אומדן להשוואה בלבד **$0.224** לכל שניית פלט |
| תצורהמחיר וידאו | טבלת תעריפים— | כמות חזויה— | רכיב חיוב— | רזולוציית ייחוס— | מצב ייחוס— | שמע ייחוס— | יחידת חיובלכל שניית וידאו | תנאי חיובמצב יצירה: text\_to\_video; רזולוציה: 720p | חיוב פלט · מחיר וידאו · אומדן להשוואה בלבד **$0.224** לכל שניית וידאו |
| תצורהעלות יצירה משוערת | טבלת תעריפים— | כמות חזויהאומדן ליצירה אחת | רכיב חיוב— | רזולוציית ייחוס— | מצב ייחוס— | שמע ייחוס— | יחידת חיוב— | תנאי חיוב— | חיוב פלט · עלות יצירה משוערת · אומדן להשוואה בלבד **$0.672** אומדן לפני היצירה אומדן זה אינו חיוב נוסף או תעריף קבוע עבור היצירה שהושלמה. |

לפני הבקשה Ailoot משריינת סכום משוער. לאחר קבלת התוצאה היא מסדירה את החיוב הסופי לפי השימוש המדוד. הסדרת חיוב בהזרמה משתמשת ברשומת השימוש הסופית. [איך פועלים שריון הסכום והסדרת החיוב →](https://ailoot.ai/docs/he/billing/reserve/)

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

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

הפניות למחירי תצורות וידאו

#### מחירים לפי תצורה

התאימו כל חיוב לתנאים המוצגים. השתמשו בתעריף אחד לכל קבוצה של תצורות חלופיות.

| תצורה | תנאי חיוב | חיוב |
| --- | --- | --- |
| תצורהמחיר וידאו | תנאי חיובלא הוגדר תנאי נוסף במפתח תמחור זה. | חיוב פלט · מחיר וידאו **$0.224** לכל שניית וידאו מחיר הייחוס שפורסם עבור התצורה המוצגת. החיובים הסופיים נקבעים לפי התצורה שחויבה בפועל. |
| תצורהמחיר וידאו | תנאי חיובאודיו: with\_audio | חיוב פלט · מחיר וידאו **$0.336** לכל שניית וידאו מחיר הייחוס שפורסם עבור התצורה המוצגת. החיובים הסופיים נקבעים לפי התצורה שחויבה בפועל. |
| תצורהמחיר וידאו | תנאי חיובמצב יצירה: text\_to\_video; רזולוציה: 480p | חיוב פלט · מחיר וידאו **$0.224** לכל שניית וידאו מחיר הייחוס שפורסם עבור התצורה המוצגת. החיובים הסופיים נקבעים לפי התצורה שחויבה בפועל. |
| תצורהמחיר וידאו | תנאי חיובמצב יצירה: text\_to\_video; רזולוציה: 720p | חיוב פלט · מחיר וידאו **$0.224** לכל שניית וידאו מחיר הייחוס שפורסם עבור התצורה המוצגת. החיובים הסופיים נקבעים לפי התצורה שחויבה בפועל. |
| תצורהמחיר וידאו | תנאי חיובמצב יצירה: image\_to\_video; רזולוציה: 720p | חיוב פלט · מחיר וידאו **$0.224** לכל שניית וידאו מחיר הייחוס שפורסם עבור התצורה המוצגת. החיובים הסופיים נקבעים לפי התצורה שחויבה בפועל. |
| תצורהמחיר וידאו | תנאי חיובמצב יצירה: text\_to\_video; רזולוציה: 1080p | חיוב פלט · מחיר וידאו **$0.224** לכל שניית וידאו מחיר הייחוס שפורסם עבור התצורה המוצגת. החיובים הסופיים נקבעים לפי התצורה שחויבה בפועל. |
| תצורהמחיר וידאו | תנאי חיובמצב יצירה: image\_to\_video; רזולוציה: 1080p | חיוב פלט · מחיר וידאו **$0.224** לכל שניית וידאו מחיר הייחוס שפורסם עבור התצורה המוצגת. החיובים הסופיים נקבעים לפי התצורה שחויבה בפועל. |

### דוגמאות לבקשות

#### 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":"kwaivgi/kling-v3.0-pro","prompt":"A serene mountain landscape at sunset","resolution":"720p"}', 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** [`kwaivgi/kling-v3.0-pro`](https://ailoot.ai/models/he/#m=kwaivgi%2Fkling-v3.0-pro&route=Ultra&caller=kwaivgi%2Fkling-v3.0-pro&fmt=videos)

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

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

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

[`kwaivgi/kling-v3.0-pro`](https://ailoot.ai/models/he/#m=kwaivgi%2Fkling-v3.0-pro&route=Ultra&caller=kwaivgi%2Fkling-v3.0-pro&fmt=videos)

FAQ · Kling: Video v3.0 Pro

אילו קלטים ותוצאות זמינים?

`POST /v1/videos` · `kwaivgi/kling-v3.0-pro`: `text`, `image` → `video`

באילו שדות הבקשה משתמשת?

`POST /v1/videos` · `kwaivgi/kling-v3.0-pro`: `model`, `prompt`, `duration`, `resolution`, `aspect_ratio`, `generate_audio`, `frame_images`, `input_references`, `size`, `callback_url`, `session_id`, `trace`, `user`

אילו מגבלות חלות?

`POST /v1/videos` · `kwaivgi/kling-v3.0-pro`: `duration.minimum`: `1`; `duration.maximum`: `600`; `frame_images.max_items`: `2`; `frame_images.min_items`: `1`

חברו 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 במוצרי לקוחות, בסוכנים, באפליקציות ובאוטומציות.