kling-v1-6
פרופיל kling-v1-6 יוצר וידאו מתיאור סצנה כתוב. תכננו שוט קצר עם נושא, פעולה וכיוון מצלמה ברורים, באמצעות אפשרויות משך הזמן המתועדות של חמש או עשר שניות. היצירה אסינכרונית: שמרו את זהות המשימה שהוחזרה ושלפו את הווידאו שהושלם אחרי שהמשימה המקורית מצליחה.
על המודל
התיאור הזה מציג את יכולות המודל. הקלט, הפלט והאפשרויות הזמינים ב-Ailoot מפורטים בהמשך לפי השיטה שנבחרה.
הבורר המדויק kling-v1-6 מזהה את פרופיל הטקסט לווידאו של Kling. שלחו JSON אל POST /v1/videos/generations עם model המוגדר ל-kling-v1-6 והסצנה הכתובה ב-prompt. גם POST /v1/videos מקבל את אותה בקשת יצירה. בקשה ברורה מתארת מה נראה, מה קורה במהלך השוט וכיצד המצלמה מתבוננת בו. בקשת הסצנה המינימלית מספקת את בורר המודל ואת prompt, ומשאירה בקרות שוט נוספות ללא הגדרה.
לשוט מוצר, תארו את העצם, המשטח, התאורה ופעולה גלויה אחת, כגון סיבוב אטי או שינוי במיקום המצלמה. לקונספט של סצנה, הגדירו את הסביבה, הנושא הראשי והתנועה דרך הפריים. השאירו את הפעולה ברורה במסגרת הקליפ המבוקש. prompt יכול לתאר סירה קטנה שחוצה אגם שקט, מבט רחב מהגדה, אור בוקר מוקדם ומצלמה יציבה שעוקבת אחר כיוון הסירה.
מגבלת prompt היא 500 תווים. negative_prompt האופציונלי יכול להכיל עד 200 תווים ומתאר רכיבים לא רצויים. אפשרויות duration המתועדות לפרופיל הזה הן 5 ו-10 שניות. ערכי mode הם std ו-pro. cfg_scale הוא מספר בין 0 ל-1; התיעוד מתאר ערכים גבוהים יותר כהיצמדות חזקה יותר לטקסט. בחרו בקרות לשוט המדויק ושמרו את הערכים שנשלחו יחד עם התוצאה.
אובייקט camera_control המתועד מפרט את סוגי המצלמה simple, down_back, forward_up, right_turn_forward ו-left_turn_forward. תצורת simple שלו מציינת את הבקרות horizontal, vertical, pan, tilt, roll ו-zoom. דוגמת הטקסט המינימלית מספקת נקודת התחלה מועילה כאשר אפשר לתאר סצנה בלי אובייקט בקרת מצלמה נפרד. תנו לתנועת המצלמה מטרה ברורה ב-prompt, כגון חשיפת הנושא או מעקב אחר תנועתו.
השליחה מפעילה משימה אסינכרונית. שמרו את id שהוחזר, את כותרת X-Ailoot-Task-Id ואת polling_url, ואז השתמשו ב-GET על אותו polling_url עם אותו מפתח API של Ailoot כדי לקרוא את המשימה המקורית. מצב המשימה נמצא ב-data.task_status: הערכים submitted ו-processing מציינים המתנה, succeed מציין הצלחה ו-failed מציין כישלון. לכן אישור שליחה הוא תוצאת ביניים. בהצלחה, שלפו כל כתובת URL ב-data.task_result.videos[].url; אלו קישורים לקובצי תוצאה בניהול Ailoot. GET /v1/videos/{id}/content שולף את הפלט הראשון, ופרמטר השאילתה index שלו בוחר פלט שהוחזר לפי האינדקס שלו שמתחיל באפס. שמרו את תגובת המצב עם הקליפ שנבחר. אם מתרחש פסק זמן או מתקבלת תגובת result_pending_check, שמרו את הזהות המקורית שהוחזרה ובדקו את אותה פעולה במקום לשלוח שוב את השוט.
בדקו את הסרטון שהושלם לכל אורכו: הפעולה המבוקשת, מראה הנושא, המסגור והתנועה הם כולם חלק מתיאור השוט. הפרופיל המדויק הזה מספק את תהליך הטקסט לווידאו המתואר כאן. משימה שהוחזרה ועדיין דורשת בדיקת מצב יש להמשיך לבדוק באמצעות זהותה המקורית, גם כאשר בקשת לקוח חורגת מהזמן הקצוב; שמרו את פרטי המשימה האלה לפני שתשקלו בקשת יצירה חדשה.
Ailoot Ultra · Video POST /v1/videos kling-v1-6
kling-v1-6התחלה
פרופיל kling-v1-6 יוצר וידאו מתיאור סצנה כתוב. תכננו שוט קצר עם נושא, פעולה וכיוון מצלמה ברורים, באמצעות אפשרויות משך הזמן המתועדות של חמש או עשר שניות. היצירה אסינכרונית: שמרו את זהות המשימה שהוחזרה ושלפו את הווידאו שהושלם אחרי שהמשימה המקורית מצליחה.
- סוגי קלט נתמכים
- טקסט
- תוצאות
- וידאו
זמין ב-Ailoot · קלט ושיטות
Ailoot Ultra · Video POST /v1/videos
- סוגי קלט
text- סוגי פלט
video
| שדה | סוג | דרישה | ערכים ומגבלות | ברירת מחדל |
|---|---|---|---|---|
שדהmodel | סוגstring | דרישהחובה | ערכים ומגבלות kling-v1-6 | ברירת מחדל— |
שדהprompt | סוגstring | דרישהחובה | ערכים ומגבלות | ברירת מחדל— |
שדהmode | סוגstring | דרישהחובה | ערכים ומגבלות std, pro | ברירת מחדל— |
שדהmodel_name | סוגstring | דרישהרשות | ערכים ומגבלות kling-v1-6 | ברירת מחדל— |
שדהcfg_scale | סוגnumber | דרישהרשות | ערכים ומגבלות מינימום: 0 מקסימום: 1 | ברירת מחדל— |
שדהaspect_ratio | סוגstring | דרישהרשות | ערכים ומגבלות | ברירת מחדל— |
שדהnegative_prompt | סוגstring | דרישהרשות | ערכים ומגבלות | ברירת מחדל— |
שדה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 | מפרטmodel selects this model. An omitted model_name uses the selected model; an explicit native model_name override is preserved. |
כינויים לשיטה: /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 טוקנים |
| תצורהEstimated generation cost | טבלת תעריפים— | כמות חזויהאומדן ליצירה אחת | חיוב קלט · עלות יצירה משוערת · אומדן להשוואה בלבד $6 אומדן לפני היצירה This estimate is not an additional charge or a fixed rate for the completed generation. |
לפני הבקשה 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-v1-6", "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.
קבלה ושמירה של תוצאות
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 שהוחזר בפועל.
Retain the complete response, all actual results, original identifiers, usage and response headers.
כשצריך לבדוק את התגובה המקורית
Keep the returned public task or operation id and all headers. Read only the original task; unknown or result_pending_check does not authorize another creation.
שדות התגובה
| שדה | סוג |
|---|---|
שדהdata.task_result.videos[].url | סוגstring or array, as returned |
כינויים
כינויים למודל
Ailoot Ultra kling-v1-6
כינויים לנתיבי שיטות
/v1/videos/generations
מזהי מודלים קשורים IDs
FAQ · kling-v1-6
- אילו קלטים ותוצאות זמינים?
POST /v1/videos·kling-v1-6:text→video- באילו שדות הבקשה משתמשת?
POST /v1/videos·kling-v1-6:model,prompt,mode,model_name,cfg_scale,aspect_ratio,negative_prompt,duration- אילו מגבלות חלות?
POST /v1/videos·kling-v1-6:cfg_scale.minimum:0;cfg_scale.maximum:1