Kling: Video v3.0 Standard

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

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

על המודל

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

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

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

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

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

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

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

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

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

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

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

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

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

kwaivgi/kling-v3.0-std

Kuaishou /kwaivgi/kling-v3.0-std

התחלה

סוגי קלט נתמכים: טקסט · תמונות
תוצאות: וידאו

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

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

סוגי קלט: text, image
סוגי פלט: video
פורמט פלט: הבתים המקוריים של MP4; ללא נרמול או המרת קידוד

שדה	סוג	דרישה	ערכים ומגבלות	ברירת מחדל
שדה`model`	סוג`string`	דרישהחובה	ערכים ומגבלות kwaivgi/kling-v3.0-std	ברירת מחדל—
שדה`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-std

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-std

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.168 לכל שניית פלט
תצורהמחיר וידאו	טבלת תעריפים—	כמות חזויה—	רכיב חיוב—	רזולוציית ייחוס—	מצב ייחוס—	שמע ייחוס—	יחידת חיובלכל שניית וידאו	תנאי חיובאודיו: with_audio	חיוב פלט · מחיר וידאו · אומדן להשוואה בלבד $0.252 לכל שניית וידאו
תצורהוידאו מתמונה (תמונות פריימים) · 1080p · תעריף ייחוס	טבלת תעריפים—	כמות חזויה—	רכיב חיוב`reference_output_rate`	רזולוציית ייחוס1080p	מצב ייחוסמתמונות לווידאו (תמונות פריימים)	שמע ייחוסללא שמע	יחידת חיובלכל שניית פלט	תנאי חיוב—	חיוב פלט · תעריף ייחוס לשניית וידאו בפלט · אומדן להשוואה בלבד $0.168 לכל שניית פלט
תצורהמחיר וידאו	טבלת תעריפים—	כמות חזויה—	רכיב חיוב—	רזולוציית ייחוס—	מצב ייחוס—	שמע ייחוס—	יחידת חיובלכל שניית וידאו	תנאי חיובמצב יצירה: image_to_video; רזולוציה: 720p	חיוב פלט · מחיר וידאו · אומדן להשוואה בלבד $0.168 לכל שניית וידאו
תצורהוידאו מטקסט · 1080p · תעריף ייחוס	טבלת תעריפים—	כמות חזויה—	רכיב חיוב`reference_output_rate`	רזולוציית ייחוס1080p	מצב ייחוסמטקסט לווידאו	שמע ייחוסללא שמע	יחידת חיובלכל שניית פלט	תנאי חיוב—	חיוב פלט · תעריף ייחוס לשניית וידאו בפלט · אומדן להשוואה בלבד $0.168 לכל שניית פלט
תצורהוידאו מטקסט · 480p · תעריף ייחוס	טבלת תעריפים—	כמות חזויה—	רכיב חיוב`reference_output_rate`	רזולוציית ייחוס480p	מצב ייחוסמטקסט לווידאו	שמע ייחוסללא שמע	יחידת חיובלכל שניית פלט	תנאי חיוב—	חיוב פלט · תעריף ייחוס לשניית וידאו בפלט · אומדן להשוואה בלבד $0.168 לכל שניית פלט
תצורהמחיר וידאו	טבלת תעריפים—	כמות חזויה—	רכיב חיוב—	רזולוציית ייחוס—	מצב ייחוס—	שמע ייחוס—	יחידת חיובלכל שניית וידאו	תנאי חיובמצב יצירה: text_to_video; רזולוציה: 720p	חיוב פלט · מחיר וידאו · אומדן להשוואה בלבד $0.168 לכל שניית וידאו
תצורהעלות יצירה משוערת	טבלת תעריפים—	כמות חזויהאומדן ליצירה אחת	רכיב חיוב—	רזולוציית ייחוס—	מצב ייחוס—	שמע ייחוס—	יחידת חיוב—	תנאי חיוב—	חיוב פלט · עלות יצירה משוערת · אומדן להשוואה בלבד $0.504 אומדן לפני היצירה אומדן זה אינו חיוב נוסף או תעריף קבוע עבור היצירה שהושלמה.

לפני הבקשה Ailoot משריינת סכום משוער. לאחר קבלת התוצאה היא מסדירה את החיוב הסופי לפי השימוש המדוד. הסדרת חיוב בהזרמה משתמשת ברשומת השימוש הסופית. איך פועלים שריון הסכום והסדרת החיוב →

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

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

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

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

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

תצורה	תנאי חיוב	חיוב
תצורהמחיר וידאו	תנאי חיובלא הוגדר תנאי נוסף במפתח תמחור זה.	חיוב פלט · מחיר וידאו $0.168 לכל שניית וידאו מחיר הייחוס שפורסם עבור התצורה המוצגת. החיובים הסופיים נקבעים לפי התצורה שחויבה בפועל.
תצורהמחיר וידאו	תנאי חיובאודיו: with_audio	חיוב פלט · מחיר וידאו $0.252 לכל שניית וידאו מחיר הייחוס שפורסם עבור התצורה המוצגת. החיובים הסופיים נקבעים לפי התצורה שחויבה בפועל.
תצורהמחיר וידאו	תנאי חיובמצב יצירה: text_to_video; רזולוציה: 480p	חיוב פלט · מחיר וידאו $0.168 לכל שניית וידאו מחיר הייחוס שפורסם עבור התצורה המוצגת. החיובים הסופיים נקבעים לפי התצורה שחויבה בפועל.
תצורהמחיר וידאו	תנאי חיובמצב יצירה: text_to_video; רזולוציה: 720p	חיוב פלט · מחיר וידאו $0.168 לכל שניית וידאו מחיר הייחוס שפורסם עבור התצורה המוצגת. החיובים הסופיים נקבעים לפי התצורה שחויבה בפועל.
תצורהמחיר וידאו	תנאי חיובמצב יצירה: image_to_video; רזולוציה: 720p	חיוב פלט · מחיר וידאו $0.168 לכל שניית וידאו מחיר הייחוס שפורסם עבור התצורה המוצגת. החיובים הסופיים נקבעים לפי התצורה שחויבה בפועל.
תצורהמחיר וידאו	תנאי חיובמצב יצירה: text_to_video; רזולוציה: 1080p	חיוב פלט · מחיר וידאו $0.168 לכל שניית וידאו מחיר הייחוס שפורסם עבור התצורה המוצגת. החיובים הסופיים נקבעים לפי התצורה שחויבה בפועל.
תצורהמחיר וידאו	תנאי חיובמצב יצירה: image_to_video; רזולוציה: 1080p	חיוב פלט · מחיר וידאו $0.168 לכל שניית וידאו מחיר הייחוס שפורסם עבור התצורה המוצגת. החיובים הסופיים נקבעים לפי התצורה שחויבה בפועל.

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

Ailoot Ultra · וידאו

curl · צרו סרטון

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-std","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 · אחזור מצב הפעולה המקורית

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 kwaivgi/kling-v3.0-std

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

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

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

kwaivgi/kling-v3.0-std

FAQ · Kling: Video v3.0 Standard

אילו קלטים ותוצאות זמינים?: POST /v1/videos · kwaivgi/kling-v3.0-std: text, image → video
באילו שדות הבקשה משתמשת?: POST /v1/videos · kwaivgi/kling-v3.0-std: 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-std: duration.minimum: 1; duration.maximum: 600; frame_images.max_items: 2; frame_images.min_items: 1

Kling: Video v3.0 Standard