איך משתמשים ב-API של Kling 4.0: מצבים, פריימי מפתח, רפרנסים, עריכת וידאו והארכת וידאו

כדי להשתמש ב-API של ⁦Kling 4.0⁩, צור API key, שלח ב-POST גוף JSON אחד עם מזהה המודל kling-4-0 והפרומפט שלך, ותשאל את המשימה שחוזרת עד שכתובת הווידאו מוכנה. אותה נקודת קצה מכסה את כל חמשת המצבים: מטקסט לווידאו, מתמונה לווידאו עם עד 10 פריימים, רפרנסים של תמונות, סרטונים ואודיו, עריכת וידאו והארכת וידאו. המדיה שאתה שולח ושדה אחד, omni_reference_task_type, קובעים איזה מצב יפעל.

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

מה צריך לפני הבקשה הראשונה?

1. API key. צור מפתח בדף מפתחות API ושמור אותו בשרת שלך. לעולם אל תכניס אותו לקוד שרץ בדפדפן.
2. קרדיטים. הוסף יתרה בדף החיוב. הקרדיטים לא פגים לעולם, ומשימות שנכשלו אינן מחויבות.
3. מזהה המודל kling-4-0.

export SEEDROUTER_API_KEY="your-key"

איך שולחים בקשת ⁦Kling 4.0⁩?

שלח את המשימה ב-POST אל ⁦/v1/videos/generations⁩:

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"
  }'

התגובה היא משימה, לא וידאו:

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

לכל שדה מלבד model ובמרבית המצבים גם prompt יש ברירת מחדל:

אין מתג סאונד: כל קליפ של ⁦Kling 4.0⁩ מגיע עם רצועת סטריאו. אין גם שדה mode, negative_prompt או watermark. הסכמה קפדנית, ולכן שדה לא מוכר נדחה עם HTTP 400 לפני שנוצרת משימה, ושגיאת הקלדה לעולם לא הופכת לקליפ בתשלום שבו ההגדרה הושמטה בשקט.

איך מקבלים את הווידאו?

תשאל את ⁦GET /v1/tasks/{id}⁩ כל 10–20 שניות עד ש-status הוא completed או failed. חמש הרצות הבדיקה שלנו נמשכו בין 2 דקות ו-41 שניות ל-4 דקות ו-22 שניות לקליפים של 3 שניות ב-720p, אז היערך להמתנה של דקות ולא של שניות.

import os
import time
import requests

API = "https://api.seedrouter.ai/v1"
HEADERS = {"Authorization": f"Bearer {os.environ['SEEDROUTER_API_KEY']}"}

task = requests.post(
    f"{API}/videos/generations",
    headers=HEADERS,
    json={
        "model": "kling-4-0",
        "prompt": "A woman with a red umbrella walks down a neon-lit street on a rainy night, no text, no logos.",
        "duration": 5,
    },
    timeout=60,
)
task.raise_for_status()
task_id = task.json()["id"]

while True:
    result = requests.get(f"{API}/tasks/{task_id}", headers=HEADERS, timeout=60).json()
    if result["status"] in ("completed", "failed"):
        break
    time.sleep(15)

if result["status"] == "completed":
    print(result["output"]["video_url"])
else:
    print(result["error"])

כך נראית משימה שהסתיימה:

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

זה הקליפ שהבקשה הראשונה בדף הזה הפיקה, 5 שניות ב-720p:

⁦Kling 4.0⁩, מטקסט לווידאו, 720p, 5 שניות, עם סאונד סטריאו.

קליפי ה-720p שלנו חזרו כ-⁦MP4 (H.264)⁩ ב-⁦1280 × 720⁩ עם רצועת AAC בסטריאו. הורד את הקובץ לאחסון שלך: הקישורים המאוחסנים אינם קבועים. פסק זמן ברשת בזמן התשאול לא אומר שהיצירה נכשלה, אז שמור את מזהה המשימה ובדוק אותה שוב במקום לשלוח משימה חדשה.

באיזה מצב פועלת בקשת ⁦Kling 4.0⁩?

המדיה בגוף הבקשה קובעת את המצב. omni_reference_task_type מגדיר אותו במפורש במקרים שבהם המדיה לבדה עשויה להיות דו-משמעית:

אי אפשר לשלב פריימים ומדיית רפרנס באותה בקשה, ושדה video_url ללא edit או extend נדחה. שני המקרים מחזירים HTTP 400 לפני שקיימת משימה.

איך קובעים פריימי מפתח ב-⁦Kling 4.0⁩?

שלח image_with_roles, רשימה של אובייקטי ⁦{url, role}⁩. בדיוק first_frame אחד, last_frame אופציונלי ועד 8 רשומות keyframe, 10 תמונות בסך הכול. פריימי המפתח משמשים לפי הסדר שבו אתה מציין אותם, כך שהרשימה היא ציר הזמן.

{
  "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
}

אם צריך רק התחלה וסיום, ⁦image_urls: [first, last]⁩ קצר יותר. מתמונה לווידאו הוא המצב היחיד שבו אפשר להשמיט את prompt; הקליפ מקבל את צורת הפריים הראשון.

איך משתמשים ברפרנסים של תמונות, וידאו ואודיו?

הוסף video_urls (עד 5 קליפים, עד 30 שניות בשימוש בסך הכול), audio_urls (עד 3 קליפים של 5–30 שניות) ותמונות רפרנס, עד 15 קבצים בסך הכול. ציין אותם בפרומפט בתור @Image1, @Video1 ו-@Audio1, עם מספור מ-1 בכל רשימה:

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

אפשר לשלוח תמונות רפרנס גם ב-image_urls, אבל רק עם ⁦omni_reference_task_type: "reference"⁩; בלעדיו, image_urls מפורשות כפריים ראשון ואחרון. הסאונד המקורי של סרטון רפרנס מוחלף כברירת מחדל; הגדר ⁦audio_setting: "origin"⁩ כדי לשמור עליו.

איך עורכים וידאו עם ⁦Kling 4.0⁩?

הגדר את omni_reference_task_type ל-edit, העבר את הווידאו ב-video_url, ותאר את השינוי. אפשר לשלוח עד 10 תמונות רפרנס ב-image_urls.

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

הקלט חייב להיות באורך של לפחות 3 שניות, ורק 30 השניות הראשונות שלו משמשות. השמט את duration והתוצאה תהיה באורך וידאו הקלט; הסאונד המקורי נשמר אלא אם תגדיר ⁦audio_setting: "auto"⁩.

איך מאריכים וידאו?

הגדר את omni_reference_task_type ל-extend, העבר את הווידאו, וציין ב-duration את אורך החלק החדש. ⁦Kling 4.0⁩ ממשיך מהפריים האחרון ומחזיר את המקור יחד עם השניות החדשות בקובץ אחד. בבדיקה שלנו קליפ של 5.2 שניות שהוארך ב-3 שניות חזר באורך 8.1 שניות.

{
  "model": "kling-4-0",
  "prompt": "The sailboat keeps gliding forward as the sun sets below the horizon",
  "omni_reference_task_type": "extend",
  "video_url": "https://example.com/in.mp4",
  "duration": 3
}

הוסף last_frame_image כדי לבחור איפה החלק החדש מסתיים. הארכת וידאו שומרת על יחס הגובה-רוחב והסאונד של הקלט, ולכן aspect_ratio ו-audio_setting נדחים.

כמה עולה בקשת ⁦Kling 4.0⁩?

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

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

וידאו שאי אפשר לקרוא את אורכו נדחה לפני שמחויב משהו, ומשימה שנכשלת אינה מחויבת.

אילו בקשות נדחות לפני שמחויב משהו?

הבקשות האלה חוזרות עם HTTP 400 בשליחה, בלי שנוצרת משימה ובלי חיוב:

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

האם סוכן קוד יכול להריץ את זה בשבילך?

כן. בדף ⁦Kling 4.0⁩ יש פרומפט מוכן ל-Claude Code, Codex או Cursor שקורא את המפתח מהסביבה שלך, מציג לך את הבקשה ואת העלות שלה, מחכה לאישור שלך, ואז שולח, מתשאל ומוריד את הקליפ. באותו דף יש Playground ששולח בדיוק את הגוף שהקוד שלך היה שולח, עם כל השדות מחולקים לפי מצב.

שאלות על ה-API של ⁦Kling 4.0⁩

האם ה-API של ⁦Kling 4.0⁩ בחינם?

לא. התשלום הוא לפי שנייה של וידאו. חשבונות SeedRouter חדשים מקבלים קרדיט קטן כדי לנסות אותו, אין מנוי, ומשימות שנכשלו אינן מחויבות.

האם ⁦Kling 4.0 Flash⁩ זמין ב-API?

עדיין לא. ⁦Kling 4.0 Flash⁩ הוא מודל נפרד וקל יותר באותה משפחה; Kling מציגה אותו עם קליפים קצרים יותר ב-720p וללא ריבוי פריימי מפתח.^[1] מזהה המודל kling-4-0 הוא ⁦Kling 4.0⁩ המלא.

במה ⁦Kling 4.0⁩ שונה מ-⁦Kling 3.0⁩ ב-API?

⁦Kling 4.0⁩ יוצר קליפים של עד 30 שניות, מקבל פריימי מפתח ורפרנסים של וידאו ואודיו, ויכול לערוך או להאריך וידאו; הסאונד תמיד פועל. ⁦Kling 3.0⁩ יוצר קליפים של 3–15 שניות, מציע 4K, פרומפטים בריבוי שוטים ואלמנטים בעלי שמות, וכולל מתג סאונד. מדריך ה-API של ⁦Kling 3.0⁩ מפרט את השדות שלו. Kling הכריזה על 4.0 עם אורך של 30 שניות, 10 פריימי מפתח וסאונד סטריאו ב-30 בספטמבר 2026.^[2]

אפשר לבטל משימה?

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

מקורות

1. Kling — בינה מלאכותית. Kling 4.0 video generation (סקירת מאפיינים ושאלות נפוצות). נבדק ב-8 באוקטובר 2026 ב-kling.ai.
2. Kling — בינה מלאכותית. Introducing Kling 4.0: Visual Realism, Creative Control, and Next-Level Storytelling. 30 בספטמבר 2026. נבדק ב-8 באוקטובר 2026 ב-kling.ai.