Video
PixVerse V6
צור קליפים של PixVerse V6 באורך 1–15 שניות מטקסט, מתמונה, משני פריימים, מתמונות ייחוס או מקליפ קודם, מ-360p עד 1080p, בחיוב לפי שנייה.
PixVerse V6 הוא מודל הווידאו של PixVerse. מזהה מודל אחד מכסה חמישה מצבים: מטקסט לווידאו, מתמונה לווידאו, מעבר בין פריים ראשון ואחרון, ייחוס ממספר תמונות והארכת קליפ שכבר יצרת. המצב נקבע לפי השדות שאתה שולח. הקליפים באורך 1–15 שניות ב-360p, 540p, 720p או 1080p, עם אודיו מקורי אופציונלי. שלח את הבקשה, שמור את מזהה המשימה שחוזר, וקרא את הווידאו המוכן מתוך המשימה. התמונות נשלחות ככתובות URL.
מזהי מודל
| מזהה מודל | קלטים | רזולוציות | אורך |
|---|---|---|---|
pixverse-v6 | טקסט, תמונה אחת, פריים ראשון + אחרון, 1–7 תמונות ייחוס, משימת pixverse-v6 שהושלמה | 360p, 540p, 720p, 1080p | 1–15 שניות |
ראה את דף המודל למחירים הנוכחיים. לשוט יחיד עם יותר פרטים מטקסט או מתמונה אחת, ראה את PixVerse V6 Max.
דוגמה מהירה
curl https://api.seedrouter.ai/v1/videos/generations \
-H "Authorization: Bearer $SEEDROUTER_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "pixverse-v6",
"prompt": "A red paper boat drifting on a calm pond at sunrise, soft mist, slow push-in. No text, no logos.",
"resolution": "540p",
"duration": 5,
"size": "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 | חובה | pixverse-v6 |
prompt | string | חובה | עד 5,000 תווים. חובה בכל מצב. |
resolution | enum | 540p | 360p, 540p, 720p או 1080p. |
duration | integer | 5 | 1–15 שניות. מעבר בין פריים ראשון ואחרון נמשך רק 5 או 8. |
size | enum | 16:9 | 16:9, 4:3, 1:1, 3:4, 9:16, 2:3, 3:2 או 21:9. משמש ליצירה מטקסט לווידאו ולייחוס ממספר תמונות; המצבים האחרים פועלים לפי התמונות שלהם. |
audio | boolean | false | יצירת אודיו מקורי. מחויב בתעריף האודיו. |
seed | integer | אין | 0–2147483647. אותה בקשה ואותו סיד נותנים תוצאות דומות. |
negative_prompt | string | אין | מה לא להכניס לקליפ. עד 2,048 תווים. |
watermark | boolean | false | הוספת סימן מים. |
motion_mode | enum | normal | רק normal נתמך. |
generate_multi_clip_switch | boolean | false | יצירה בריבוי קליפים. ביצירה מטקסט לווידאו ומתמונה לווידאו בלבד. |
image_urls | רשימת כתובות URL | אין | מתמונה לווידאו. נעשה שימוש בתמונה הראשונה. |
first_frame_image | URL | אין | מעבר: הפריים הראשון. שלח אותו יחד עם last_frame_image. |
last_frame_image | URL | אין | מעבר: הפריים האחרון. שלח אותו יחד עם first_frame_image. |
img_references | רשימת כתובות URL | אין | ייחוס ממספר תמונות: 1–7 תמונות. |
extend_from_task_id | string | אין | הארכה: המזהה של אחת ממשימות pixverse-v6 שהשלמת. |
הסכמה קפדנית: שדות לא מוכרים נדחים ולא מתעלמים מהם. callback_url אינו זמין; תשאל את המשימה במקום זאת.
מצבים
השדות שאתה שולח קובעים את המצב. שלח שדות של מצב אחד בכל בקשה.
| מצב | מה לשלוח | הערות |
|---|---|---|
| מטקסט לווידאו | ללא שדות תמונה או הארכה | size קובע את הצורה. |
| מתמונה לווידאו | image_urls | הקליפ נפתח בתמונה הראשונה. |
| מעבר | first_frame_image + last_frame_image | 5 או 8 שניות. |
| ייחוס ממספר תמונות | img_references (1–7 כתובות URL) | משלב דמויות, חפצים או סצנות מהתמונות; size קובע את הצורה. |
| הארכה | extend_from_task_id | ממשיך משימת pixverse-v6 שהשלמת בעצמך. |
{
"model": "pixverse-v6",
"prompt": "The puppy slowly turns into a kitten, soft studio light.",
"first_frame_image": "https://example.com/puppy.jpg",
"last_frame_image": "https://example.com/kitten.jpg",
"duration": 5
}{
"model": "pixverse-v6",
"prompt": "The paper boat drifts on toward a lily pad.",
"extend_from_task_id": "task_...",
"resolution": "540p",
"duration": 5
}הארכה מחזירה את קליפ המקור ואחריו המקטע החדש, ומחייבת רק את ה-duration של המקטע החדש. בבדיקה שלנו, הארכה של שנייה אחת לקליפ של שנייה אחת חזרה באורך 2.1 שניות וחויבה על שנייה אחת.
קלטי מדיה
התמונות הן כתובות HTTP(S) ציבוריות. כתובות data URI ב-base64 אינן מתקבלות: העלה את הקובץ לאחסון שלך והעבר את הכתובת שלו. השתמש בתמונות JPG, PNG או WebP בגודל של עד 20 MB.
גורמי עלות
בדוק את מדור המחירים של המודל לתעריפים הנוכחיים. PixVerse V6 מחויב לפי שנייה של וידאו, בתעריף שנקבע לפי הרזולוציה ולפי יצירת אודיו:
cost = duration × rate per second for the resolution and audio settingכל המצבים עולים אותו דבר לשנייה; הארכה מחויבת רק על המקטע החדש. האורך ידוע כשהבקשה מתקבלת, כך שהסכום שנשמר הוא הסכום שמחויב. החיובים הסופיים מופיעים בהיסטוריית השימוש בחשבון שלך. משימות שנכשלו אינן מחויבות.
מבנה הפלט
השליחה מחזירה את המשימה:
{"id": "task_...", "model": "pixverse-v6", "status": "processing", "created_at": 1789689600}קבלת המשימה
GET https://api.seedrouter.ai/v1/tasks/{task_id}תשאל כל 10–20 שניות עד ש-status הוא completed או failed. פסק זמן ברשת בזמן התשאול לא אומר שהיצירה נכשלה: שמור את מזהה המשימה והמשך לבדוק אותה. אל תיצור משימה נוספת כדי לבדוק התקדמות.
משימה שהושלמה
{
"id": "task_...",
"model": "pixverse-v6",
"status": "completed",
"created_at": 1789689600,
"finished_at": 1789689640,
"output": {
"video_url": "https://static.seedrouter.ai/media/tasks/task_example/0.mp4"
}
}בבדיקות שלנו, קליפים באורך שנייה אחת ב-360p וביחס 16:9 חזרו כ-MP4 (H.264) ב-640 × 360, תוך 36–45 שניות מהשליחה.
שגיאות
בקשות שנדחות לפני שנוצרת משימה מחזירות שגיאת HTTP עם אובייקט error ואינן מחויבות. משימה שנכשלת אחרי שהתקבלה מחזירה HTTP 200 בתשאול, עם status: "failed" ואובייקט error.
ראה את קטלוג השגיאות המשותף לקודים, לסטטוסי HTTP ולהנחיות ניסיון חוזר.
{
"id": "task_...",
"model": "pixverse-v6",
"status": "failed",
"error": {
"code": 60001,
"message": "The request was rejected by the content policy. Please revise the prompt or input images."
}
}אם השליחה עצמה נתקלת בפסק זמן, בדוק את המשימות שלך לפני ששולחים שוב: ייתכן שהבקשה הראשונה התקבלה.
טיפים
- תאר בפרומפט נושא, מקום, תנועת מצלמה ותאורה; ציין את הצלילים שאתה רוצה כאשר
audioפעיל. - הכן טיוטה ב-
360pאו ב-540p, ואז רנדר את השוט הסופי ב-1080pעם אותה בקשה ואותוseed. - לווידאו אנכי, שלח
size: "9:16"ביצירה מטקסט לווידאו, או תמונה אנכית. - הוסף
no text, no logosכדי למנוע סימנים מומצאים.
