Grok Imagine Video 1.5

Grok Imagine Video 1.5 הוא מודל הווידאו של xAI. בקשה אחת יוצרת קליפ של 6–15 שניות עם סאונד מפרומפט, או מפרומפט ותמונה אחת, ב-480p או ב-720p וביחס ⁦16:9⁩, ⁦9:16⁩ או ⁦1:1⁩. שלח את הבקשה, שמור את מזהה המשימה שחוזר, וקרא את הווידאו המוכן מתוך המשימה. התמונות נשלחות ככתובות URL.

מזהי מודל

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

דוגמה מהירה

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

נקודת קצה

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

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

פרמטרים

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

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

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

{
  "model": "grok-imagine-video-1-5",
  "prompt": "The subject slowly turns toward the camera, soft natural light, gentle breeze, quiet room tone.",
  "image_urls": ["https://example.com/start.png"],
  "resolution": "720p",
  "duration": 6
}

קלטי מדיה

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

גורמי עלות

בדוק את מדור המחירים של המודל לתעריפים הנוכחיים. Grok Imagine Video 1.5 מחויב לפי שנייה של וידאו, בתעריף שנקבע לפי הרזולוציה:

cost = duration × rate per second for the resolution

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

מבנה הפלט

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

{"id": "task_...", "model": "grok-imagine-video-1-5", "status": "processing", "created_at": 1789689600}

קבלת המשימה

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

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

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

{
  "id": "task_...",
  "model": "grok-imagine-video-1-5",
  "status": "completed",
  "created_at": 1789689600,
  "finished_at": 1789689720,
  "output": {
    "video_url": "https://static.seedrouter.ai/media/tasks/task_example/0.mp4"
  }
}

בבדיקות שלנו, קליפים של 8 שניות ב-720p חזרו כ-⁦MP4 (H.264)⁩ עם רצועת אודיו AAC ב-⁦1280 × 720⁩ עבור 16:9, ב-⁦720 × 1280⁩ עבור 9:16 וב-⁦720 × 720⁩ עבור 1:1, תוך 111–133 שניות מהשליחה. קליפים ב-480p חזרו תוך 45–84 שניות.

שגיאות

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

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

{
  "id": "task_...",
  "model": "grok-imagine-video-1-5",
  "status": "failed",
  "error": {
    "code": 60001,
    "message": "The request was rejected by the content policy. Please revise the prompt or input images."
  }
}

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

טיפים

• תאר נושא, מקום, תנועת מצלמה ותאורה, וציין את הצלילים שאתה רוצה; האודיו נוצר יחד עם התמונה.
• הכן טיוטה ב-480p, ואז רנדר את השוט הסופי ב-720p עם אותה בקשה.
• לווידאו אנכי, שלח aspect_ratio: "9:16" או תמונה אנכית.
• הוסף no text, no logos כדי למנוע סימנים מומצאים.

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

• Playground ומחירים של Grok Imagine Video 1.5
• תיעוד ה-API של Kling 3.0 Turbo
• הורדת OpenAPI
• Markdown להעתקה