Kling 3.0 Turbo

צור קליפים של Kling 3.0 Turbo באורך 3–15 שניות עם סאונד מפרומפט או מפריים ראשון, ב-720p או ב-1080p, בחיוב לפי שנייה ובמסירה כמשימה.

Kling 3.0 Turbo הוא מודל וידאו ממשפחת Kling 3.0 של Kuaishou. בקשה אחת יוצרת קליפ של 3–15 שניות עם סאונד מפרומפט, או מפרומפט ופריים ראשון, ב-720p או ב-1080p. שלח את הבקשה, שמור את מזהה המשימה שחוזר, וקרא את הווידאו המוכן מתוך המשימה. התמונות נשלחות ככתובות URL.

מזהי מודל

מזהה מודל	קלטים	רזולוציות	אורך
`kling-3-0-turbo`	טקסט, פריים ראשון	`720p`, `1080p`	3–15 שניות

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

דוגמה מהירה

curl https://api.seedrouter.ai/v1/videos/generations \
  -H "Authorization: Bearer $SEEDROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "kling-3-0-turbo",
    "prompt": "A red paper boat drifting on a calm pond at sunrise, soft mist, slow push-in. No text, no logos.",
    "resolution": "720p",
    "duration": 5,
    "aspect_ratio": "16:9"
  }'

נקודת קצה

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

כותרת	ערך
Authorization	`Bearer YOUR_API_KEY`
Content-Type	`application/json`

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

פרמטרים

שדה	סוג	ברירת מחדל	הערות
`model`	string	חובה	`kling-3-0-turbo`
`prompt`	string	חובה	עד 3,072 תווים, או 2,500 עם פריים ראשון. חובה גם עם פריים ראשון.
`first_frame_image`	URL	אין	הפריים הראשון של הקליפ. בלעדיו, הקליפ הוא מטקסט לווידאו.
`resolution`	enum	`720p`	`720p` או `1080p`.
`duration`	integer	`5`	3–15 שניות.
`aspect_ratio`	enum	`16:9`	`16:9`, `9:16` או `1:1`. רק מטקסט לווידאו: עם פריים ראשון, הפריים קובע את הצורה.
`watermark`	boolean	אין	`true` מוסיף סימן מים. אם השדה מושמט, אין לקליפ סימן מים.

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

מתמונה לווידאו

העבר פריים ראשון ב-first_frame_image ותאר ב-prompt מה קורה אחר כך. הקליפ נפתח בפריים ומקבל את הצורה שלו, ולכן אין שימוש ב-aspect_ratio.

{
  "model": "kling-3-0-turbo",
  "prompt": "The subject slowly turns toward the camera, soft natural light, gentle breeze.",
  "first_frame_image": "https://example.com/frame.png",
  "resolution": "1080p",
  "duration": 5
}

קלטי מדיה

הפריים הראשון הוא כתובת ⁦HTTP(S)⁩ ציבורית. כתובות data URI ב-base64 אינן מתקבלות: העלה את הקובץ לאחסון שלך והעבר את הכתובת שלו. השתמש בתמונת JPG או PNG בגודל של עד 10 MB.

גורמי עלות

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

cost = duration × rate per second for the resolution

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

מבנה הפלט

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

{"id": "task_...", "model": "kling-3-0-turbo", "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-turbo",
  "status": "completed",
  "created_at": 1789689600,
  "finished_at": 1789689710,
  "output": {
    "video_url": "https://static.seedrouter.ai/media/tasks/task_example/0.mp4"
  }
}

בבדיקות שלנו, קליפים של 3 שניות ב-720p חזרו כ-⁦MP4 (H.264)⁩ ב-⁦1280 × 720⁩, וקליפים של 5 שניות ב-1080p חזרו ב-⁦1920 × 1080⁩, כולם עם רצועת אודיו סטריאו, בין 54 שניות לכ-5 דקות ו-20 שניות אחרי השליחה.

שגיאות

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

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

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

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

טיפים

תאר נושא, מקום, תנועת מצלמה ותאורה במשפט אחד לכל אחד; המודל מציית לשפת מצלמה כמו "slow push-in" (תנועה איטית פנימה) ו-"low angle" (זווית נמוכה).
הכן טיוטה ב-720p, ואז רנדר את השוט הסופי ב-1080p עם אותה בקשה.
עם פריים ראשון, תאר רק את מה שזז: הפריים כבר קובע את הסצנה.
הוסף no text, no logos כדי למנוע סימנים מומצאים.