Kling 3.0

Kling 3.0 הוא מודל יצירת הווידאו של Kuaishou. בקשה אחת יוצרת קליפ של 3–15 שניות מפרומפט, או מפריים ראשון ופריים אחרון אופציונלי, בשלושה מצבי איכות (std, pro, 4K), עם סאונד מקורי כשמבקשים אותו. קליפ יכול להיות גם רצף של עד חמישה שוטים, לכל אחד פרומפט ואורך משלו. שלח את הבקשה, שמור את מזהה המשימה שחוזר, וקרא את הווידאו המוכן מתוך המשימה. התמונות נשלחות ככתובות URL.

מזהי מודל

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

דוגמה מהירה

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": "pro",
    "duration": 5,
    "aspect_ratio": "16:9"
  }'

נקודת קצה

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

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

פרמטרים

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

קליפים בריבוי שוטים

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

{
  "model": "kling-3-0",
  "mode": "pro",
  "multi_shots": true,
  "multi_prompt": [
    {"prompt": "A red paper boat on a calm pond at sunrise, wide shot", "duration": 3},
    {"prompt": "The boat drifts under a small wooden bridge, low angle", "duration": 3}
  ]
}

אלמנטים

אלמנט הוא נושא שהמודל שומר עקבי לאורך הקליפ: אדם, מוצר או דמות. תן לו name, description קצר ו-2–4 תמונות שלו, ואז ציין אותו בשמו בפרומפט (למשל @hero).

{
  "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(S)⁩ ציבורית. כתובות data URI ב-base64 אינן מתקבלות: העלה את הקובץ לאחסון שלך והעבר את הכתובת שלו. השתמש בתמונות JPG או PNG בגודל של עד 10 MB.

גורמי עלות

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

billed seconds = duration                      (single shot)
billed seconds = Σ multi_prompt[].duration     (multi_shots: true)
cost = billed seconds × rate per second

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

מבנה הפלט

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

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

קבלת המשימה

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

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

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

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

בבדיקות שלנו, קליפ std של 3 שניות חזר כ-⁦MP4 (H.264)⁩ ב-⁦1280 × 720⁩, וקליפ pro של 5 שניות עם sound חזר ב-⁦1920 × 1080⁩ עם רצועת אודיו, כל אחד תוך כשתיים עד שלוש דקות.

שגיאות

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

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

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

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

טיפים

• תאר נושא, מקום, תנועת מצלמה ותאורה במשפט אחד לכל אחד; Kling מציית לשפת מצלמה כמו "slow push-in" (תנועה איטית פנימה) ו-"low angle" (זווית נמוכה).
• הכן טיוטה ב-std, ואז רנדר את השוט הסופי ב-pro או ב-4K עם אותה בקשה.
• השתמש בפריים ראשון ובפריים אחרון כדי לשלוט איפה שוט מתחיל ומסתיים.
• חלק סצנה לשוטים עם multi_prompt במקום לתאר כמה קאטים בפרומפט אחד.
• הוסף no text, no logos כדי למנוע סימנים מומצאים.

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

• Playground ומחירים של Kling 3.0
• הורדת OpenAPI
• Markdown להעתקה