דילוג לתוכן

Kling Video · v3 · Pro · Motion Control

שילוב

מזהה מודל kling-video/v3/pro/motion-control
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.com/v1/run/kling-video/v3/pro/motion-control?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "image": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg",
    "video": "https://content.doitong.com/video/showcase/v3/gen_fox_cartoon.mp4",
    "character_orientation": "image"
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://api.doitong.com/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

קבצים כמו בדוגמה: ⁨‏1.68 ‏$⁩ 1,680 קרדיטי API הקבצים שלכם נמדדים לפני ההרצה הרצה בדף הזה

קבלת מפתח API
Kling ווידאו לווידאו קלטים מסוג רפרנס #stylized#transform#editing

העברת תנועה ברמת Pro, שמחילה את תנועת הדמות מסרטון ייחוס על תמונת דמות

Kling · ווידאו

התוצאה הראשונה שלך תופיע כאן

בנו בקשה למטה והריצו אותה עם מפתח ה־API שלכם. הפלטים מועתקים לאחסון שלנו ונשמרים לצמיתות או למשך 7 ימים ללא תשלום.

בנה בקשה

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

0 / 2500
•חובה image_url
גרור קובץ, או

כתובת URL של תמונת ייחוס ליצירת וידאו, עם מגבלת גודל קובץ של 10.0MB, רוחב וגובה בטווח 340px–3850px, ויחס גובה-רוחב בין 0.40 ל-2.50. תמונה זו מנחה את הדמויות, הרקעים ויתר הרכיבים בווידאו. עבור דמויות, יש לוודא פרופורציות גוף ברורות, ללא הסתרה, וכיסוי של יותר מ-5% משטח התמונה.

•חובה video_url
גרור קובץ, או

כתובת URL המפנה לווידאו שפעולות הדמות בו מנחות את הפלט; עליו להציג דמות בסגנון מציאותי וללא חסימות, כאשר הראש וכל הגוף או פלג הגוף העליון נראים. ההגדרה character_orientation מגבילה את האורך ל-10s עבור 'image' או ל-30s עבור 'video'. מגבלות הקובץ: עד 100 MB, רוחב וגובה בטווח 340px–3850px, ואורך בין 3.0s ל-30.05s.

character_orientation •חובה

מקור כיוון הדמות: 'image' תואם לתמונת הייחוס ומתאים יותר למעקב אחר תנועות מצלמה, עם מקסימום של 10 שניות. לתנועות מורכבות עדיף 'video': הוא תואם לכיוון וידאו הייחוס ומאפשר עד 30 שניות.

מתקדם enable_safety_checker · keep_original_sound · elements

קישור פנים אופציונלי לשיפור שימור הזהות בווידאו הפלט, מוגבל ל-element שהועלה אחד. השתמשו ב-@Element1 כדי להפנות אליו בהנחיה. הקישור זמין רק כאשר character_orientation מוגדר ל-'video'.

POST /run/kling-video/v3/pro/motion-control?wait=20 הצעת מחיר → ⁨‏1.68 ‏$⁩
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.com/v1/run/kling-video/v3/pro/motion-control?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "image": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg",
    "video": "https://content.doitong.com/video/showcase/v3/gen_fox_cartoon.mp4",
    "character_orientation": "image"
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://api.doitong.com/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

הרצת הבקשה הזו

המפתח שלך נשאר בדפדפן הזה: הוא נשלח רק אל Doitong API ונשמר ב-localStorage רק אם מסמנים זכור. קבל מפתח API

מידע על Kling Video · v3 · Pro · Motion Control

משלב תמונת דמות ב־`image_url` עם תנועות מווידאו ייחוס ב־`video_url`. `character_orientation` נדרש ובוחר אם הכיוון עוקב אחר התמונה או הווידאו. נתמכת `prompt` אופציונלית באורך של עד 2500 תווים, `keep_original_sound` משמר את אודיו הייחוס, וניתן לקשר אלמנט פנים אחד דרך `elements` כדי לסייע בשמירה על הזהות.

פרמטרים

שלח את השם הקנוני או את השם המקומי, לא את שניהם. שמות קנוניים

שםסוג ברירת מחדלמותר תיאור
enable_safety_checkerאופציונלי
סוגboolean
ברירת מחדלtrue
ניתן להשבית בדיקות בטיחות רק באישור החשבון; בקשות ללא הרשאה תמיד נבדקות.
promptאופציונלי
סוגstring | null
≤ 2,500 תווים
image_urlחובה image
סוגurl · image
כתובת URL של תמונת ייחוס ליצירת וידאו, עם מגבלת גודל קובץ של 10.0MB, רוחב וגובה בטווח 340px–3850px, ויחס גובה-רוחב בין 0.40 ל-2.50. תמונה זו מנחה את הדמויות, הרקעים ויתר הרכיבים בווידאו. עבור דמויות, יש לוודא פרופורציות גוף ברורות, ללא הסתרה, וכיסוי של יותר מ-5% משטח התמונה.
video_urlחובה video
סוגurl · video
כתובת URL המפנה לווידאו שפעולות הדמות בו מנחות את הפלט; עליו להציג דמות בסגנון מציאותי וללא חסימות, כאשר הראש וכל הגוף או פלג הגוף העליון נראים. ההגדרה character_orientation מגבילה את האורך ל-10s עבור 'image' או ל-30s עבור 'video'. מגבלות הקובץ: עד 100 MB, רוחב וגובה בטווח 340px–3850px, ואורך בין 3.0s ל-30.05s.
keep_original_soundאופציונלי
סוגboolean
ברירת מחדלtrue
קובע אם הצליל המקורי של וידאו הייחוס נשמר.
character_orientationחובה
סוגenum
imagevideo
מקור כיוון הדמות: 'image' תואם לתמונת הייחוס ומתאים יותר למעקב אחר תנועות מצלמה, עם מקסימום של 10 שניות. לתנועות מורכבות עדיף 'video': הוא תואם לכיוון וידאו הייחוס ומאפשר עד 30 שניות.
elementsאופציונלי
סוגobject[]
קישור פנים אופציונלי לשיפור שימור הזהות בווידאו הפלט, מוגבל ל-element שהועלה אחד. השתמשו ב-@Element1 כדי להפנות אליו בהנחיה. הקישור זמין רק כאשר character_orientation מוגדר ל-'video'.
elements[].frontal_image_urlאופציונלי
סוגurl · image
תמונה חזיתית המציגה את התצוגה הראשית של ה-element. גודל הקובץ לא יעלה על 50 MB; הרוחב והגובה חייבים להיות לפחות 300px כל אחד, עם יחס גובה-רוחב בין 0.40 ל-2.50.
elements[].reference_image_urlsאופציונלי
סוגurl[] · image
ספקו 1–3 תמונות ייחוס נוספות המציגות זוויות שונות. לכל תמונה חייב להיות יחס גובה-רוחב בין 0.40 ל-2.50, שתי מידות של לפחות 300px, וגודל של עד 50.0MB.
חובה שם קנוני, מתקבל גם הוא

פרמטרים של קבצים מקבלים URL ציבורי מסוג https://, כתובת URI מסוג data: בגודל של עד 10 MB, או את file_url של העלאה. קבצים

פלט

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "kling-video/v3/pro/motion-control",
  "status": "succeeded",
  "created_at": "2026-10-20T12:00:00Z",
  "started_at": "2026-10-20T12:00:02Z",
  "completed_at": "2026-10-20T12:00:09Z",
  "queue_position": null,
  "cost": {
    "credits": 1680,
    "usd": "1.68",
    "charged": 1680,
    "refunded": 0
  },
  "input": {
    "image_url": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg",
    "video_url": "https://content.doitong.com/video/showcase/v3/gen_fox_cartoon.mp4",
    "character_orientation": "image"
  },
  "output": {
    "video": {
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.mp4",
      "content_type": "video/mp4",
      "file_name": "0-output.mp4",
      "file_size": 1843200
    }
  },
  "outputs": [
    {
      "type": "video",
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.mp4",
      "content_type": "video/mp4",
      "file_size": 1843200,
      "width": 1280,
      "height": 720,
      "duration": 5,
      "stored": true
    }
  ],
  "error": null,
  "metrics": {
    "inference_seconds": 6.8
  },
  "urls": {
    "self": "https://api.doitong.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t/cancel"
  }
}
הקבצים שלכם, הבחירה שלכםכל outputs[].url הוא עותק באחסון שלנו: נשמר לצמיתות (בתשלום לפי GB-חודש) או למשך 7 ימים ללא תשלום, בהתאם להגדרת החשבון או ל־?storage=.
אותו מבנה בכל מודלtype, url, content_type, width, height ו-duration, עבור תמונות, וידאו ואודיו כאחד. output הוא אובייקט התוצאה של המודל עצמו.
שדות הפלט
video
object {url, content_type, file_name, file_size}וידאו שנוצר על ידי המודל.

מודלים נוספים: ווידאו לווידאו

לסוכני AI: דף זה בפורמט Markdown נמצא בכתובת https://doitong.com/he/developers/models/kling-video/v3/pro/motion-control.md. כל המודלים והמדריכים: https://doitong.com/developers/llms.txt