Kling 4.0

⁦Kling 4.0⁩ הוא מודל הווידאו של Kuaishou שהוכרז בספטמבר 2026. מזהה מודל אחד מכסה חמישה מצבים: מטקסט לווידאו, מתמונה לווידאו עם עד 10 פריימים, יצירה לפי רפרנסים של תמונות, סרטונים ואודיו, עריכת וידאו והארכת וידאו. כל קליפ נמשך 3–30 שניות ב-720p או ב-1080p עם סאונד סטריאו. שלח את הבקשה, שמור את מזהה המשימה שחוזר, וקרא את הווידאו המוכן מתוך המשימה. המדיה נשלחת ככתובות URL.

מזהי מודל

ראה את דף המודל למחירים הנוכחיים.

דוגמה מהירה

curl https://api.seedrouter.ai/v1/videos/generations \
  -H "Authorization: Bearer $SEEDROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "kling-4-0",
    "prompt": "A woman with a red umbrella walks down a neon-lit street on a rainy night, signs shimmering in the puddles, the camera tracking low beside her. No text, no logos.",
    "resolution": "720p",
    "duration": 5,
    "aspect_ratio": "16:9"
  }'

נקודת קצה

POST https://api.seedrouter.ai/v1/videos/generations

התגובה היא משימה (⁦{"id": "task_...", "status": "processing"}⁩), לא הווידאו המוכן. תשאל את ⁦GET /v1/tasks/{task_id}⁩ כדי לקבל את התוצאה. שמור מפתחות API בקוד בצד השרת.

פרמטרים

כל קליפ מגיע עם סאונד סטריאו; אין מתג סאונד. אין שדה mode, negative_prompt, watermark או שדה לריבוי שוטים. הסכמה קפדנית: שדות לא מוכרים נדחים ולא מתעלמים מהם. callback_url אינו זמין; תשאל את המשימה במקום זאת.

מצבים

המצב נקבע לפי המדיה שאתה שולח ולפי omni_reference_task_type:

אי אפשר לשלב פריימים ומדיית רפרנס באותה בקשה. לצד סרטוני רפרנס או אודיו, image_urls נחשבות לתמונות רפרנס רק עם ⁦omni_reference_task_type: "reference"⁩; אחרת, השתמש בתפקידי reference_image. שדה video_url ללא edit או extend נדחה.

פריימי מפתח

{
  "model": "kling-4-0",
  "prompt": "A girl walks from the window to the door, then looks back and smiles",
  "image_with_roles": [
    {"url": "https://example.com/1.png", "role": "first_frame"},
    {"url": "https://example.com/2.png", "role": "keyframe"},
    {"url": "https://example.com/3.png", "role": "last_frame"}
  ],
  "duration": 10
}

יצירה לפי רפרנסים

{
  "model": "kling-4-0",
  "prompt": "The woman from @Image1 walks along the beach with the camera movement of @Video1",
  "image_with_roles": [{"url": "https://example.com/woman.png", "role": "reference_image"}],
  "video_urls": ["https://example.com/camera.mp4"],
  "aspect_ratio": "auto",
  "duration": 5
}

עריכת וידאו

{
  "model": "kling-4-0",
  "prompt": "Change the scene to a snowy winter evening",
  "omni_reference_task_type": "edit",
  "video_url": "https://example.com/in.mp4"
}

וידאו הקלט חייב להיות באורך של לפחות 3 שניות; רק 30 השניות הראשונות שלו משמשות. בלי duration, הפלט תואם לווידאו הקלט.

הארכת וידאו

{
  "model": "kling-4-0",
  "prompt": "The camera keeps moving forward as the sky grows darker",
  "omni_reference_task_type": "extend",
  "video_url": "https://example.com/in.mp4",
  "duration": 5
}

ההארכה ממשיכה מהפריים האחרון של וידאו הקלט ומחזירה את המקור יחד עם החלק החדש. הוסף last_frame_image כדי לבחור איפה הוא מסתיים.

קלטי מדיה

תמונות, סרטונים ואודיו נשלחים ככתובות ⁦HTTP(S)⁩ ציבוריות. כתובות נתונים מסוג URI בקידוד base64 אינן מתקבלות: העלה את הקבצים לאחסון שלך והעבר את הכתובות שלהם. תמונות, סרטונים ואודיו יחד מוגבלים ל-15 קובצי רפרנס לכל היותר.

גורמי עלות

בדוק את מדור המחירים של המודל לתעריפים הנוכחיים. ⁦Kling 4.0⁩ מחויב לפי שנייה של וידאו, בתעריף שנקבע לפי הרזולוציה:

text, image, reference without videos:  cost = duration × standard rate
extend:                                 cost = new seconds × standard rate
edit, reference with videos:            cost = (output + max(output, input)) × video-input rate

input הוא האורך המצטבר של סרטוני הקלט, מעוגל כלפי מעלה לשניות שלמות ומוגבל ל-30. הוא נמדד כשהבקשה מתקבלת, כך שהסכום שנשמר הוא הסכום שמחויב. וידאו שאי אפשר לקרוא את אורכו נדחה לפני שמחויב משהו. לדוגמה: עריכת וידאו של 5.2 שניות לתוצאה של 3 שניות מחויבת על ⁦3 + 6 = 9⁩ שניות. משימות שנכשלו אינן מחויבות.

מבנה הפלט

השליחה מחזירה את המשימה:

{"id": "task_...", "model": "kling-4-0", "status": "processing", "created_at": 1789689600}

קבלת המשימה

GET https://api.seedrouter.ai/v1/tasks/{task_id}

תשאל כל 10–20 שניות עד ש-status הוא completed או failed. פסק זמן ברשת בזמן התשאול לא אומר שהיצירה נכשלה: שמור את מזהה המשימה והמשך לבדוק אותה. אל תיצור משימה נוספת כדי לבדוק התקדמות.

משימה שהושלמה

{
  "id": "task_...",
  "model": "kling-4-0",
  "status": "completed",
  "created_at": 1789689600,
  "finished_at": 1789689800,
  "output": {
    "video_url": "https://static.seedrouter.ai/media/tasks/task_example/0.mp4"
  }
}

בבדיקות שלנו, קליפים של 3 שניות ב-720p חזרו כ-⁦MP4 (H.264)⁩ ב-⁦1280 × 720⁩ עם רצועת AAC בסטריאו, בין 2 דקות ו-41 שניות ל-4 דקות ו-22 שניות אחרי השליחה. וידאו של 5.2 שניות שהוארך חזר באורך 8.1 שניות.

שגיאות

בקשות שנדחות לפני שנוצרת משימה מחזירות שגיאת HTTP עם אובייקט error ואינן מחויבות. משימה שנכשלת אחרי שהתקבלה מחזירה HTTP 200 בתשאול, עם ⁦status: "failed"⁩ ואובייקט error.

ראה את קטלוג השגיאות המשותף לקודים, לסטטוסי HTTP ולהנחיות ניסיון חוזר.

{
  "id": "task_...",
  "model": "kling-4-0",
  "status": "failed",
  "error": {
    "code": 60001,
    "message": "The request was rejected by the content policy. Please revise the prompt or input images."
  }
}

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

טיפים

• תאר נושא, מקום, תנועת מצלמה, תאורה וסאונד; האודיו של הקליפ פועל לפי הפרומפט.
• הכן טיוטה ב-720p, ואז רנדר את השוט הסופי ב-1080p עם אותה בקשה.
• הוסף פריימי מפתח לקליפים ארוכים יותר כדי שהסצנה תתקדם בכיוון שאתה רוצה.
• הוסף no text, no logos כדי למנוע סימנים מומצאים.

קישורים רלוונטיים

• Playground ומחירים של ⁦Kling 4.0⁩
• תיעוד ה-API של ⁦Kling 3.0⁩
• הורדת OpenAPI
• Markdown להעתקה