grok-imagine-video

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

Ailoot · וידאו POST /v1/videos/generations grok-imagine-video

על המודל

התיאור הזה מציג את יכולות המודל. הקלט, הפלט והאפשרויות הזמינים ב-Ailoot מפורטים בהמשך לפי השיטה שנבחרה.

מתיאור לסרטון

Grok Imagine Video יוצר וידאו מטקסט. למודל xAI עצמו יש גם מצבים עם תמונת מקור ועם וידאו מקור. בשיטת היצירה שפורסמה ב־Ailoot הקלט הוא תיאור טקסטואלי, והתוצאה סרטון.

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

משך ופריים

ליצירת סרטון זמין משך בין 1 ל־15 שניות. פורמטי הפריים כוללים 1:1, 16:9, 9:16, 4:3, 3:4, 3:2 ו־2:3; הפורמט הרגיל הוא 16:9. בגרסה זו זמינים 480p ו־720p, ואילו 1080p שייך לגרסה 1.5.

הנפשת תמונת המקור

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

עריכה מכוונת

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

סרטון המקור לעריכה מוגבל ל־8,7 שניות, והתוצאה לרזולוציה שאינה גבוהה מ־720p. חומר ב־1080p מוקטן ל־720p. הגדרות יצירה מטקסט אינן חלות אוטומטית על עריכה.

המשך סרטון מוכן

במצב נפרד של xAI גרסה זו ממשיכה את סרטון המקור מהפריים האחרון שלו. ה־MP4 המקורי חייב להיות באורך בין 2 ל־15 שניות; החלק שמתווסף בין 2 ל־10 שניות, ובברירת מחדל 6. התוצאה משלבת את הווידאו המקורי ואת ההמשך. היחסים והרזולוציה נלקחים מהמקור, עם מגבלה של 720p; אי אפשר לשנות אותם בנפרד במצב זה. יכולת היצרן הזאת שונה מהיצירה שפורסמה ב־Ailoot מטקסט.

תמונות ייחוס וגבולות הגרסה

xAI מספקת שימוש בתמונות ייחוס חזותיות כדי לכוון את מראה האנשים, הבגדים והעצמים בסצנה. תמונת הייחוס קובעת מאפיינים חזותיים, ולא את התמונה המדויקת של הפריים הראשון. ב־Grok Imagine Video הקלאסי אי אפשר לשלב פריים ראשון עם תמונות ייחוס.

גרסה זו אינה מקבלת קיבוע מדויק של פריים אחרון או פריימי מפתח ביניים. היכולות האלה שייכות ל־Grok Imagine Video 1.5. יצירה, הנפשת תמונת המקור ושינוי סרטון מוכן הם מצבים שונים; השיטה שפורסמה ב־Ailoot כאן מתארת יצירה מטקסט.

Ailoot · וידאו POST /v1/videos/generations grok-imagine-video

grok-imagine-video

xAI /grok-imagine-video

התחלה

סוגי קלט נתמכים: טקסט
תוצאות: וידאו

זמין ב-Ailoot · קלט ושיטות

Ailoot · וידאו POST /v1/videos/generations

סוגי קלט: text
סוגי פלט: video
פורמט פלט: mp4

שדה	סוג	דרישה	ערכים ומגבלות	ברירת מחדל
שדה`model`	סוג`string`	דרישהחובה	ערכים ומגבלות grok-imagine-video	ברירת מחדל—
שדה`prompt`	סוג`string`	דרישהרשות	ערכים ומגבלות אורך מזערי: ⁦1⁩	ברירת מחדל—
שדה`duration`	סוג`integer`	דרישהרשות	ערכים ומגבלות מינימום: ⁦1⁩ מקסימום: ⁦15⁩ תנאים: אין לספק גם duration וגם seconds יחידה: שניות	ברירת מחדל⁦1⁩
שדה`seconds`	סוג`integer\|integer_string`	דרישהרשות	ערכים ומגבלות מינימום: ⁦1⁩ מקסימום: ⁦15⁩ חלופה: duration	ברירת מחדל—
שדה`resolution`	סוג`string`	דרישהרשות	ערכים ומגבלות 480p, 720p	ברירת מחדל480p
שדה`aspect_ratio`	סוג`string`	דרישהרשות	ערכים ומגבלות 1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3 תנאים: אם סופקה תמונת קלט ויחס גובה־רוחב הושמט, הספק משתמש ביחס של התמונה	ברירת מחדל16:9
שדה`size`	סוג`string`	דרישהרשות	ערכים ומגבלות 1280x720, 720x1280, 1920x1080, 1080x1920 תנאים: חייב להתאים ל־resolution/aspect_ratio אם שניהם צוינו	ברירת מחדל—
שדה`image`	סוג`object`	דרישהרשות	ערכים ומגבלות תנאים: תמונת קלט ממשית ונתמכת; מאפשרת להשמיט את ההנחיה	ברירת מחדל—

שילובים של חומרי קלט

מטקסט לווידאו · נדרש: prompt

מתמונה לווידאו · נדרש: image

פרמטרים ומחזור חיים של השיטה

פרמטר	מפרט
פרמטר`material_types`	מפרטtext
פרמטר`required`	מפרטnull
פרמטר`optional_controls`	מפרטnull

מחזור חיים: submit_once_poll_original

GET /v1/videos/{request_id}

GET /v1/videos/generations/{request_id}

GET /v1/videos/{request_id}/content

GET /v1/videos/generations/{request_id}/content

מבני המתודות והמזהים מדויקים; יכולת הספק נפרדת מקבלת הבקשה לביצוע.

תעריפים

תעריפי שיטות Ailoot

Ailoot וידאוPOST /v1/videos/generations

קלט: ⁦‏0.002 ‏$⁩ לכל תמונה בקלט
קלט: ⁦‏0.01 ‏$⁩ לכל שנייה של וידאו בקלט
פלט: ⁦‏0.05 ‏$⁩ לכל שנייה ברזולוציית 480p
פלט: ⁦‏0.07 ‏$⁩ לכל שנייה ברזולוציית 720p

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

דוגמאות לבקשות

Ailoot · וידאו

דוגמת וידאו

set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
curl https://api.ailoot.ai/v1/videos/generations \
  -H "Authorization: Bearer $AILOOT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "grok-imagine-video", "prompt": "A person walks slowly through a quiet garden as the camera tracks from the side."}'

קבלה ושמירה של תוצאות

Ailoot · וידאו

mp4

GET /v1/videos/{request_id}
GET /v1/videos/generations/{request_id}
GET /v1/videos/{request_id}/content
GET /v1/videos/generations/{request_id}/content

בדיקת מצב המשימה

GET · אחזור מצב

set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
: "${AILOOT_VIDEO_ID:?Set the actual Ailoot operation ID returned by creation}"
export AILOOT_VIDEO_ID
video_id=$(python3 -c 'import os, urllib.parse; print(urllib.parse.quote(os.environ["AILOOT_VIDEO_ID"], safe=""))') || exit 1
curl "https://api.ailoot.ai/v1/videos/generations/$video_id" \
  -H "Authorization: Bearer $AILOOT_API_KEY"

קריאות תוכן נוספות

GET · אחזור תוכן

set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
: "${AILOOT_VIDEO_ID:?Set the actual Ailoot operation ID returned by creation}"
export AILOOT_VIDEO_ID
video_id=$(python3 -c 'import os, urllib.parse; print(urllib.parse.quote(os.environ["AILOOT_VIDEO_ID"], safe=""))') || exit 1
curl "https://api.ailoot.ai/v1/videos/generations/$video_id/content" \
  -H "Authorization: Bearer $AILOOT_API_KEY" \
  --output video.mp4

שמירת כל התוצאות שהושלמו

שמרו כל וידאו שהושלם או קובץ שהוחזר; אחזרו כל נכס מכל URL שהוחזר בפועל.

יש לשמור את ה־JSON המלא של הסטטוס ואת request_id בפועל. תגובה שהושלמה עם status=done מכילה video.url עם כתובת URL לתוכן שבבעלותכם. יש לשמר את המשך שדווח ואת כל שדות התוצאה שהוחזרו.

כשצריך לבדוק את התגובה המקורית

יש לקרוא את המשימה המקורית הקיימת; אין לשלוח שוב בקשה שתוצאת שליחתה אינה ידועה.

שדות התגובה

שדה	סוג
שדה`request_id`	סוגstring
שדה`id`	סוגstring
שדה`status`	סוגstring
שדה`video.url`	סוגowned signed content URL
שדה`video.duration`	סוגnumber
שדה`video.respect_moderation`	סוגboolean

שגיאות והשלבים הבאים

תגובה	תנאי	השלב הבא
תגובה⁦400⁩ · `invalid_request_error`	תנאישדות נדרשים, ייצוג חומר או ערך פרמטר שאינם תקינים	השלב הבאתקנו את השדות שצוינו לפני בקשת יצירה חדשה.
תגובה⁦409⁩ · `video_not_ready`	תנאיתוכן התוצאה המקורית עדיין אינו זמין	השלב הבאיש לבדוק במחזוריות את המזהה המקורי שהוחזר ולכבד את Retry-After.
תגובה`server_error`	תנאיהתשובה שהוחזרה מציינת שהפעולה או התוצאה דורשת בדיקה	השלב הבאשמרו את מזהה הפעולה/המשימה המקורי שהוחזר, את כותרות הבקשה ואת התשובה; המשיכו לבצע פעולות קריאה נתמכות של אותה פעולה מקורית. אל תשלחו שוב את בקשת היצירה.

כינויים

כינויים למודל

Ailoot grok-imagine-video

כינויים לנתיבי שיטות

השתמשו בנתיבי השיטות המוצגים למעלה.

מזהי מודלים קשורים IDs

grok-imagine-video

FAQ · grok-imagine-video

אילו קלטים ותוצאות זמינים?: POST /v1/videos/generations · grok-imagine-video: text → video
באילו שדות הבקשה משתמשת?: POST /v1/videos/generations · grok-imagine-video: model, prompt, duration, seconds, resolution, aspect_ratio, size, image
אילו מגבלות חלות?: POST /v1/videos/generations · grok-imagine-video: duration.minimum: 1; duration.maximum: 15; seconds.minimum: 1; seconds.maximum: 15

grok-imagine-video