Claude Opus 5.5 כבר זמין ב-SeedRouter
LogoSeedRouter

חיפוש מודלים לפי שם, למשל 'nano banana'

חיפוש מודלים לפי שם, למשל 'nano banana'

כל המאמרים

איך משתמשים ב-Kling 3.0 API: מפתח, בקשה, תשאול, פריימים וריבוי שוטים

איך משתמשים ב-Kling 3.0 API צעד אחר צעד: יוצרים מפתח, שולחים משימת וידאו, מתשאלים לקבלת כתובת הווידאו, מתחילים מפריים ראשון ואחרון ובונים קליפים בריבוי שוטים.

קריאה כ-Markdown

כדי להשתמש ב-Kling 3.0 API, צור מפתח API, שלח ב-POST גוף JSON אחד עם מזהה המודל kling-3-0 והפרומפט שלך, ותשאל את המשימה שחוזרת עד שכתובת הווידאו מוכנה. נקודת קצה אחת מכסה מטקסט לווידאו, וידאו מפריים ראשון ואחרון, קליפים בריבוי שוטים וייחוסי אלמנטים; השדות בגוף הבקשה קובעים איזה מהם.

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

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

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

איך שולחים בקשת Kling 3.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-3-0",
    "prompt": "A red paper boat drifting on a calm pond at sunrise, soft mist on the water, slow push-in, no text, no logos.",
    "mode": "std",
    "duration": 5,
    "aspect_ratio": "16:9"
  }'

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

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

לכל שדה מלבד model ו-prompt יש ברירת מחדל:

שדהברירת מחדלערכים
modeprostd (720p), pro (1080p), 4K
duration53–15 שניות
aspect_ratio16:916:9, 9:16, 1:1
soundfalsetrue יוצר סאונד מקורי

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

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

תשאל את GET /v1/tasks/{id} כל 10–20 שניות עד ש-status הוא completed או failed. בבדיקות שלנו קליפ std של 3 שניות הסתיים תוך כשתי דקות, וקליפ pro של 5 שניות עם סאונד תוך כשתיים וחצי.

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-3-0",
        "prompt": "A red paper boat drifting on a calm pond at sunrise, slow push-in, no text, no logos.",
        "mode": "std",
        "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-3-0",
  "status": "completed",
  "output": {"video_url": "https://static.seedrouter.ai/media/tasks/task_example/0.mp4"}
}

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

איך מתחילים מפריים ראשון ואחרון?

העבר כתובת URL של תמונה אחת או שתיים ב-image_urls. התמונה הראשונה פותחת את הקליפ; השנייה היא המקום שבו הוא מסתיים. בלי תמונות, הקליפ נוצר מהפרומפט בלבד.

{
  "model": "kling-3-0",
  "prompt": "The camera glides from the empty street to the lit shop window",
  "image_urls": ["https://example.com/start.png", "https://example.com/end.png"],
  "mode": "pro",
  "duration": 6
}

התמונות חייבות להיות כתובות ⁦HTTP(S)⁩ ציבוריות, בפורמט JPG או PNG. נתוני base64 נדחים; העלה קודם את הקובץ לאחסון שלך.

איך יוצרים קליפ בריבוי שוטים?

הגדר את multi_shots ל-true ותאר כל שוט ב-multi_prompt, עד חמישה שוטים של 1–12 שניות כל אחד. סך משכי השוטים חייב להיות 3–15 שניות, והסכום הזה הוא אורך הקליפ שעליו אתה מחויב; duration אינו בשימוש.

{
  "model": "kling-3-0",
  "mode": "pro",
  "sound": true,
  "multi_shots": true,
  "multi_prompt": [
    {"prompt": "Wide shot of a small open kitchen, a chef tosses vegetables in a wok, flames rising, warm light.", "duration": 3},
    {"prompt": "Close-up of the wok, vegetables flipping through the flames, oil sizzling, steam drifting.", "duration": 3}
  ]
}

זה הקליפ שהבקשה הזו הפיקה בבדיקה שלנו, וידאו אחד של 6 שניות שעובר משוט רחב לתקריב:

Kling 3.0, ⁦pro (1080p)⁩, ריבוי שוטים ⁦3 + 3⁩ שניות, עם סאונד.

איך שומרים על עקביות של אדם או מוצר?

הוסף אותו ל-kling_elements: name, description קצר ו-2–4 כתובות URL של תמונות הנושא, עד שלושה אלמנטים לבקשה. ציין את האלמנט בשמו בפרומפט.

{
  "model": "kling-3-0",
  "prompt": "@hero slowly turns toward the camera in soft window light",
  "kling_elements": [
    {
      "name": "hero",
      "description": "a young woman with short black hair and a yellow raincoat",
      "element_input_urls": ["https://example.com/hero-front.png", "https://example.com/hero-side.png"]
    }
  ]
}

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

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

בקשהלמה
קליפ בריבוי שוטים שסך השוטים בו פחות מ-3 או יותר מ-15 שניותKling 3.0 יוצר קליפים של 3–15 שניות
אלמנט בלי descriptionכל אלמנט צריך תיאור
יותר מ-2 ב-image_urls, יותר מ-5 שוטים או יותר מ-3 אלמנטיםמחוץ למגבלות המודל
mode: "4k" באות קטנההערך הוא 4K
תמונות base64, או כל שדה שלא מופיע בטבלה שלמעלההמדיה נשלחת ככתובות URL; הסכמה קפדנית

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

במה זה שונה מה-API של Kling עצמה?

ה-API למפתחים של Kling משתמש בשמות שדות משלו, והגרסה הישנה שלו והגרסה הנוכחית שונות זו מזו.[1][2] אם אתה מעביר אינטגרציה, מפה את השדות:

SeedRouterה-API הישן של Kling
model: "kling-3-0"model_name: "kling-v3"
sound: true / falsesound: "on" / "off"
duration: 5 (מספר שלם)duration: "5" (מחרוזת)
mode: "4K"mode: "4k"
image_urls: [first, last]image ו-image_tail
multi_shots + multi_prompt: [{prompt, duration}]multi_shot + shot_type: "customize" + multi_prompt: [{index, prompt, duration}]
kling_elements: [{name, description, element_input_urls}]element_list: [{element_id}], נוצר מראש

SeedRouter מוסרת תוצאות כמשימה שאתה מתשאל; callback_url אינו זמין.

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

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

שאלות על Kling 3.0 API

יש API רשמי ל-Kling 3.0?

כן. Kling מפרסמת API למפתחים עם מפתחות משלה, חיוב מבוסס יחידות ופורמט בקשה משלה.[1][3] SeedRouter היא דרך נפרדת לקרוא ל-Kling 3.0 עם מפתח אחד ויתרה אחת שמשותפת עם מודלים אחרים.

כמה עולה Kling 3.0 API?

החיוב הוא לפי שנייה של וידאו, לפי מצב ולפי אם הסאונד פועל. מדריך המחירים של Kling 3.0 API מחשב את עלויות הקליפים, ודף המודל מציג את התעריפים הנוכחיים.

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

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

מקורות

  1. Kling AI. Kling 3.0: Text to Video (תיעוד API, גרסה ישנה). אוחזר ב-6 באוקטובר 2026 מ-kling.ai.
  2. Kling AI. Kling 3.0: Image to Video (תיעוד API, גרסה ישנה). אוחזר ב-6 באוקטובר 2026 מ-kling.ai.
  3. Kling AI. Pricing: Video (API למפתחים). אוחזר ב-6 באוקטובר 2026 מ-kling.ai.
כל המאמרים

מדריכים קשורים