Kling v2.1 Master
Kling v2.1 Master יוצר וידאו מטקסט או מבריף המבוסס על תמונה. השתמשו בו לאירוע חזותי מוגדר, כשהנושא, הפעולה, הנחיות המצלמה והסיום מתוכננים יחד כשוט קצר ועקבי.
על המודל
התיאור הזה מציג את יכולות המודל. הקלט, הפלט והאפשרויות הזמינים ב-Ailoot מפורטים בהמשך לפי השיטה שנבחרה.
Kling v2.1 Master היא מהדורת וידאו של Kling עם יכולות יצירת וידאו מטקסט ומתמונה בקטלוג המודלים המתועד. בחרו בריף כתוב לסצנה כאשר אתם מפתחים רעיון חזותי מתוך טקסט, או בריף המבוסס על תמונה כאשר הנושא והקומפוזיציה כבר מוגדרים. בשני המקרים, הגדירו את האירוע שהשוט המוגמר צריך להראות.
ביצירה המבוססת על טקסט, תארו את הנושא, הסביבה והפעולה בסדר ברור. רקדן החוצה סטודיו, רכב הנוסע מתחת לעצים או חפץ זכוכית הקולט אור משתנה מעניקים לרצף מטרה מסוימת. כללו את הפרטים שקובעים את מראה הסצנה ושמרו על עקביותם לאורך הבריף.
ביצירה המבוססת על תמונה, הכינו תמונת ייחוס שמציגה את המאפיינים שהשוט צריך לשמר. הקפידו שפנים, קצוות אובייקטים וחומרים ייחודיים יהיו גלויים. תארו מה משתנה מהמראה הראשוני הזה: מחוות הנושא, תנועה בסביבה או מיקום המצלמה. השאירו את תמונת המקור זמינה בעת בחינת התוצאה.
תכננו את הפעולה סביב הסיום שלה. אדם המניח אובייקט צריך לסיים כשהאובייקט נמצא במקום שניתן לזהות; חשיפה צריכה להסתיים כשהמאפיין החשוב גלוי. כך קל יותר לבחור נקודת חיתוך בעריכה ולהעריך אם התנועה מילאה את תפקידה.
רשומת המודל המתועדת כוללת משכי זמן של חמש ועשר שניות, מצבי std ו-pro, וצורות פריים אופקיות, אנכיות וריבועיות. בחרו את הבקרים הזמינים בתהליך שנבחר ושמרו את הערכים ששימשו בפועל. העריכו את הקליפ שנוצר מול הפעולה והמסגור הרצויים, ולא לפי שם המהדורה של המודל.
תארו בנפרד את תנועת הנושא ואת תנועת המצלמה. בשוט מעקב, ציינו אחרי איזה נושא המצלמה עוקבת ואילו חלקים מהסביבה צריכים לחלוף בפריים. בשוט נייח, ציינו את התנועה שמתרחשת בתוכו. קשרו את הנחיות המצלמה למה שהצופה צריך לשים לב אליו.
בחנו את הרצף כולו מבחינת רציפות. בדקו שהנושא החשוב נשאר מזוהה, שהאינטראקציות עקביות מבחינה מרחבית ושהתזמון משאיר מקום לחיתוך המתוכנן. עקבו אחר שינויים בידיים, בפנים, בפרטי משטחים ובאובייקטים החופפים זה לזה. העריכו את התנועה לצד הפריים הבודד המוצלח ביותר.
שמרו כל סרטון מוגמר עם ההנחיה, תמונת הייחוס וההגדרות שלו. השתמשו באותו בריף כשאתם משווים סצנה בין מהדורות, ותעדו את ההבדלים החזותיים בפועל. בעת תיקון גרסה, תארו את הבעיה שנצפתה ועדכנו את ההוראה הקשורה אליה, תוך שמירה על רכיבי הסצנה השימושיים.
Ailoot Ultra · Video POST /v1/videos kling-v2-1-master
kling-v2-1-masterהתחלה
Kling v2.1 Master יוצר וידאו מטקסט או מבריף המבוסס על תמונה. השתמשו בו לאירוע חזותי מוגדר, כשהנושא, הפעולה, הנחיות המצלמה והסיום מתוכננים יחד כשוט קצר ועקבי.
- סוגי קלט נתמכים
- טקסט
- תוצאות
- וידאו
זמין ב-Ailoot · קלט ושיטות
Ailoot Ultra · Video POST /v1/videos
- סוגי קלט
text- סוגי פלט
video
| שדה | סוג | דרישה | ערכים ומגבלות | ברירת מחדל |
|---|---|---|---|---|
שדהmodel | סוגstring | דרישהחובה | ערכים ומגבלות kling-v2-1-master תנאים: השתמשו בבורר הניתוב הזה של Ailoot בדיוק כפי שהוא. | ברירת מחדל— |
שדהprompt | סוגstring | דרישהחובה | ערכים ומגבלות אורך מרבי: 500 תנאים: | ברירת מחדל— |
שדהmode | סוגstring | דרישהחובה | ערכים ומגבלות std, pro תנאים: | ברירת מחדל— |
שדהmodel_name | סוגstring | דרישהרשות | ערכים ומגבלות תנאים: דריסה אופציונלית של הערך המקורי. השמיטו אותה כדי להשתמש אוטומטית במודל שנבחר; ערך שצוין במפורש נשמר. | ברירת מחדל— |
שדהcfg_scale | סוגnumber | דרישהרשות | ערכים ומגבלות מינימום: 0 מקסימום: 1 תנאים: | ברירת מחדל— |
שדהaspect_ratio | סוגstring | דרישהרשות | ערכים ומגבלות תנאים: | ברירת מחדל— |
שדהnegative_prompt | סוגstring | דרישהרשות | ערכים ומגבלות אורך מרבי: 200 תנאים: | ברירת מחדל— |
שדהduration | סוגinteger | דרישהרשות | ערכים ומגבלות 5, 10 תנאים: | ברירת מחדל— |
פרמטרים ומחזור חיים של השיטה
| פרמטר | מפרט |
|---|---|
פרמטרcontent_type | מפרטapplication/json |
פרמטרrequired | מפרטmodel, prompt, mode |
פרמטרoptional | מפרטmodel_name, cfg_scale, aspect_ratio, negative_prompt, duration |
פרמטרmaterial_types | מפרטtext |
פרמטרconditions | מפרטהשתמשו בבורר הניתוב הזה של Ailoot בדיוק כפי שהוא., דריסה אופציונלית של הערך המקורי. השמיטו אותה כדי להשתמש אוטומטית במודל שנבחר; ערך שצוין במפורש נשמר. |
כינויים לשיטה: /v1/videos/generations
מחזור חיים: submit_once_poll_original
GET /v1/videos/{request_id}
GET /v1/videos/generations/{request_id}
GET /v1/videos/{request_id}/content
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
תעריפים
אופן חישוב החיוב הסופי
התעריפים המוצגים מספקים אומדן לעלות לפני היצירה. החיוב הסופי מחושב לפי העלות שנרשמה עבור היצירה המקורית. משך הפלט שנמדד והכמויות החזויות אינם הכמות הסופית לחיוב.
מידע תעריפים אינו מוסיף אפשרויות לבקשה. הפרמטרים הנתמכים מפורטים בשיטה שנבחרה.
- מצב מהיר
- לא צוין כאשר נבחר מצב מהיר
- מצב Flex
- לא צוין כאשר נבחר מצב flex
- מאמץ חשיבה מרבי
- לא צוין כאשר מאמץ החשיבה המרבי משתמש בהתאמת ברירת המחדל (default)
תעריפים משוערים להשוואה
מחירים לפי תצורה
התאימו כל חיוב לתנאים המוצגים. השתמשו בתעריף אחד לכל קבוצה של תצורות חלופיות.
| תצורה | טבלת תעריפים | כמות חזויה | חיוב |
|---|---|---|---|
| תצורהתעריפי בסיס לטוקנים | טבלת תעריפיםתעריף בסיס | כמות חזויה— | חיוב קלט · טוקני קלט · אומדן להשוואה בלבד — / 1K טוקנים פלט · טוקני פלט · אומדן להשוואה בלבד — / 1K טוקנים קלט · קריאה מהמטמון · אומדן להשוואה בלבד — / 1K טוקנים קלט · כתיבה למטמון · אומדן להשוואה בלבד — / 1K טוקנים קלט · כתיבה למטמון, 1 שעה · אומדן להשוואה בלבד — / 1K טוקנים |
| תצורהעלות יצירה משוערת | טבלת תעריפים— | כמות חזויהאומדן ליצירה אחת | חיוב פלט · עלות יצירה משוערת · אומדן להשוואה בלבד $6 אומדן לפני היצירה אומדן זה אינו חיוב נוסף או תעריף קבוע עבור היצירה שהושלמה. |
לפני הבקשה Ailoot משריינת סכום משוער. לאחר קבלת התוצאה היא מסדירה את החיוב הסופי לפי השימוש המדוד. הסדרת חיוב בהזרמה משתמשת ברשומת השימוש הסופית. איך פועלים שריון הסכום והסדרת החיוב →
דוגמאות לבקשות
Ailoot Ultra · Video
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
export AILOOT_API_KEY
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p=json.loads('{"model": "kling-v2-1-master", "prompt": "A happy holiday scene at the beach.", "mode": "pro"}')
Path("request.json").write_text(json.dumps(p,ensure_ascii=False))
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
# Submit once. Retain the complete result, original identifiers and every response header.
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
export AILOOT_API_KEY
python3 - <<'PY_STATUS'
import json,os,subprocess
from pathlib import Path
from urllib.parse import urljoin,urlsplit
r=json.loads(Path("result.json").read_text())
u=urljoin("https://api.ailoot.ai",r["polling_url"])
p=urlsplit(u)
if p.scheme!="https" or p.netloc!="api.ailoot.ai" or p.username or p.password:
raise SystemExit("Unexpected returned polling URL; preserve the response")
subprocess.run(["curl","--fail-with-body","--silent","--show-error",u,"-H","Authorization: Bearer "+os.environ["AILOOT_API_KEY"],"-D","status-headers.txt","-o","status.json"],check=True)
# Read this same original polling_url again while pending.
# Preserve unknown/result_pending_check; do not repeat creation.
PY_STATUS
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())
roles={}
def visit(v,path=""):
if isinstance(v,dict):
for k,x in v.items(): visit(x,path+"/"+k)
elif isinstance(v,list):
for i,x in enumerate(v): visit(x,path+"/"+str(i))
elif isinstance(v,str):
u=urljoin("https://api.ailoot.ai",v); p=urlsplit(u)
if p.scheme=="https" and p.netloc=="api.ailoot.ai" and not p.username and not p.password and p.path.startswith("/v1/media/assets/") and p.path.endswith("/content"):
roles.setdefault(u,[]).append(path)
visit(r)
if not roles: raise SystemExit("No completed owned assets; retain the original status")
manifest=[]
for i,(u,paths) in enumerate(roles.items()):
target=Path(f"asset-{i}.bin")
subprocess.run(["curl","--fail-with-body","--silent","--show-error",u,"-H","Authorization: Bearer "+os.environ["AILOOT_API_KEY"],"-o",str(target)],check=True)
raw=target.read_bytes()
if not raw: raise SystemExit("Empty asset; retain original status and metadata")
ext="glb" if raw[:4]==b"glTF" else "png" if raw[:8]==b"\x89PNG\r\n\x1a\n" else "jpg" if raw[:3]==b"\xff\xd8\xff" else "webp" if raw[:4]==b"RIFF" and raw[8:12]==b"WEBP" else "mp4" if raw[4:8]==b"ftyp" else "bin"
name=f"asset-{i}.{ext}"
if target.name!=name: target.rename(name)
manifest.append({"file":name,"response_paths":paths,"bytes":len(raw)})
Path("asset-manifest.json").write_text(json.dumps(manifest,indent=2))
print("Saved",len(manifest),"unique owned assets; every response role retained")
PY_ASSETS
קבלה ושמירה של תוצאות
Ailoot Ultra · Video
GET /v1/videos/{request_id}GET /v1/videos/generations/{request_id}GET /v1/videos/{request_id}/contentGET /v1/media/assetsGET /v1/media/assets/{asset_id}
שמירת כל התוצאות שהושלמו
שמרו כל וידאו שהושלם או קובץ שהוחזר; אחזרו כל נכס מכל URL שהוחזר בפועל.
יש לשמור את התגובה המלאה ואת הכותרות, המזהים המקוריים, כל פלט ממשי ואת כל שדות השימוש והחיוב. יש לשמור כל נכס ייחודי שבבעלותכם ואת כל התפקידים המפנים אליו.
כשצריך לבדוק את התגובה המקורית
יש לשמור את מזהה המשימה הציבורי או מזהה הפעולה שהוחזרו ואת כל הכותרות. יש לקרוא רק את המשימה המקורית; unknown או result_pending_check אינם מתירים יצירה נוספת.
שדות התגובה
| שדה | סוג |
|---|---|
שדהid | סוגstring |
שדהpolling_url | סוגstring |
שדהprovider_task_id | סוגstring |
שדהdata.task_id | סוגstring |
שדהdata.task_status | סוגstring |
שדהdata.task_result.videos[].url | סוגstring |
שגיאות והשלבים הבאים
| תגובה | תנאי | השלב הבא |
|---|---|---|
תגובה400 · invalid_request_error | תנאישדה חובה, בורר המודל, סוג או ייצוג הקלט אינם תקינים. | השלב הבאבדקו את פרטי האימות שהוחזרו לפני הכנת בקשה נפרדת. |
תגובה | תנאיהבקשה המקורית או התוצאה אינן ידועות או דורשות בדיקה. | השלב הבאשמרו את המזהים והכותרות המקוריים; קראו רק רשומות נתמכות של מצב או ספרייה. אל תשלחו שוב בקשת יצירה. |
כינויים
כינויים למודל
Ailoot Ultra kling-v2-1-master
כינויים לנתיבי שיטות
/v1/videos/generations
מזהי מודלים קשורים IDs
FAQ · Kling v2.1 Master
- אילו קלטים ותוצאות זמינים?
POST /v1/videos·kling-v2-1-master:text→video- באילו שדות הבקשה משתמשת?
POST /v1/videos·kling-v2-1-master:model,prompt,mode,model_name,cfg_scale,aspect_ratio,negative_prompt,duration- אילו מגבלות חלות?
POST /v1/videos·kling-v2-1-master:prompt.maximum_length:500;cfg_scale.minimum:0;cfg_scale.maximum:1;negative_prompt.maximum_length:200