Kling 4.0 Flash

⁦Kling 4.0 Flash⁩ הוא המודל המצומצם יותר במשפחת ⁦Kling 4.0⁩ של Kuaishou. ב-SeedRouter הוא מאפשר יצירת וידאו מטקסט ויצירה לפי רפרנסים: עד 10 תמונות רפרנס, עד 5 סרטוני רפרנס ועד 7 אלמנטים (נושאים בעלי שם שנבנים מ-⁦2–4⁩ תמונות או מסרטון קצר אחד), עם אזכור של כל אחד בפרומפט. כל קליפ נמשך ⁦3–20⁩ שניות ב-720p עם סאונד. שלח את הבקשה, שמור את מזהה המשימה שחוזר, וקרא את הווידאו המוכן מתוך המשימה. המדיה נשלחת ככתובות 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-flash",
    "prompt": "A paper boat drifts down a rain-filled city gutter at dusk, the camera skimming the water beside it past glowing shop windows, raindrops ticking on the surface. No text, no logos.",
    "duration": 5,
    "aspect_ratio": "16:9"
  }'

נקודת קצה

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

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

פרמטרים

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

אזכורים

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

כל @ שאחריו אות, ספרה, קו תחתון או תו סיני חייב לציין חומר רפרנס בבקשה הזו, אחרת הבקשה נדחית לפני שמחויב משהו. בהתאמת השמות נבדקים קודם השמות הארוכים ביותר, ללא הבחנה בין אותיות גדולות לקטנות. שם שמסתיים באות, בספרה או בקו תחתון לא יכול להיות צמוד ישירות לתו נוסף כזה: @image_12 עם תמונה אחת בלבד נדחה; כתוב ⁦@image_1 2⁩ או ⁦@image_1,⁩.

סרטוני רפרנס ואלמנטים מבוססי וידאו יחד מוגבלים ל-5 לכל היותר, ותמונות, סרטונים ואלמנטים יחד ל-15 לכל היותר.

{
  "model": "kling-4-0-flash",
  "prompt": "The dancer from @image_1 performs the routine of @video_1 on a rooftop at dusk",
  "image_urls": ["https://example.com/dancer.png"],
  "video_urls": ["https://example.com/routine.mp4"],
  "keep_original_sound": false,
  "duration": 8
}

אלמנטים

אלמנט הוא נושא בעל שם שאפשר להשתמש בו שוב בפרומפט. יש שני סוגים:

שמות מורכבים מ-⁦1–20⁩ אותיות, ספרות, קווים תחתונים או תווים סיניים, והם ייחודיים ללא הבחנה בין אותיות גדולות לקטנות. ⁦image_N, video_N, keyframe_N, object_N, audio_N, first_frame⁩ ו-last_frame הם שמות שמורים.

{
  "model": "kling-4-0-flash",
  "prompt": "@Mira opens the shop door and greets the morning crowd",
  "elements": [
    {
      "name": "Mira",
      "image_urls": ["https://example.com/mira-front.png", "https://example.com/mira-side.png"],
      "tag": "character",
      "description": "baker in a flour-dusted apron"
    }
  ],
  "aspect_ratio": "9:16",
  "duration": 6
}

קלטי מדיה

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

גורמי עלות

בדוק את מדור המחירים של המודל לתעריפים הנוכחיים. ⁦Kling 4.0 Flash⁩ מחויב לפי שנייה של וידאו ב-720p:

text, reference images, image elements:   cost = duration × standard rate
reference videos or video elements:       cost = (output + max(output, input)) × video-input rate

input הוא האורך המצטבר של סרטוני הרפרנס והאלמנטים מבוססי הווידאו, מעוגל כלפי מעלה לשניות שלמות. הוא נמדד כשהבקשה מתקבלת, כך שהסכום שנשמר הוא הסכום שמחויב. לדוגמה: קליפ של 5 שניות שמונחה על ידי סרטון רפרנס של 7.2 שניות מחויב על ⁦5 + 8 = 13⁩ שניות; עם סרטון רפרנס של 3 שניות הוא מחויב על ⁦5 + 5 = 10⁩ שניות. משימות שנכשלו אינן מחויבות.

מבנה הפלט

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

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

בבדיקות שלנו, קליפים של 5 שניות חזרו כ-⁦MP4 (H.264)⁩ ב-⁦1280 × 720⁩ עם רצועת AAC בסטריאו, ⁦91–103⁩ שניות אחרי השליחה; הקובץ ארוך מ-duration בערך בפריים אחד (5.04 שניות במקום 5).

שגיאות

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

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

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

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

טיפים

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

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

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