grok-imagine-video
Grok Imagine Video สร้างวิดีโอสั้นจากคำอธิบายข้อความ โดยเลือกระยะเวลาและอัตราส่วนเฟรมได้ ตัวโมเดลของ xAI ยังรองรับการทำภาพนิ่งเคลื่อนไหวและการแก้วิดีโอตามคำสั่ง
เกี่ยวกับโมเดล
คำอธิบายนี้ครอบคลุมความสามารถของโมเดล อินพุต เอาต์พุต และตัวเลือกที่ใช้ได้ใน 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เริ่มต้น
Grok Imagine Video สร้างวิดีโอสั้นจากคำอธิบายข้อความ โดยเลือกระยะเวลาและอัตราส่วนเฟรมได้ ตัวโมเดลของ xAI ยังรองรับการทำภาพนิ่งเคลื่อนไหวและการแก้วิดีโอตามคำสั่ง
- อินพุตที่รองรับ
- ข้อความ
- ผลลัพธ์
- วิดีโอ
ใช้งานได้ใน 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
รูปแบบเมธอดและ ID ระบุอย่างแม่นยำ ความสามารถของผู้ให้บริการแยกจากการอนุญาตให้รับคำขอ
ราคา
อัตราค่าบริการเมธอด Ailoot
POST /v1/videos/generations- ขาเข้า
- US$0.002 ต่อภาพอินพุต
- ขาเข้า
- US$0.01 ต่อวินาทีของวิดีโออินพุต
- ขาออก
- US$0.05 ต่อวินาทีที่ความละเอียด 480p
- ขาออก
- US$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}/contentGET /v1/videos/generations/{request_id}/content
ตรวจสอบสถานะงาน
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"การอ่านเนื้อหาแบบอื่น
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 | เงื่อนไขเนื้อหาผลลัพธ์เดิมยังไม่พร้อมใช้งาน | ขั้นตอนถัดไปตรวจสอบ ID เดิมที่ส่งกลับเป็นระยะ และปฏิบัติตาม Retry-After |
การตอบกลับserver_error | เงื่อนไขการตอบกลับที่ได้รับระบุว่าต้องตรวจสอบการดำเนินการหรือผลลัพธ์ | ขั้นตอนถัดไปเก็บ ID การดำเนินการ/งานที่ส่งกลับมาแต่เดิม ส่วนหัวของคำขอ และการตอบกลับไว้ แล้วอ่านข้อมูลการดำเนินการเดิมนั้นต่อด้วยวิธีที่รองรับ ห้ามส่งคำขอสร้างซ้ำ |
ชื่ออื่น
ชื่ออื่นของโมเดล
Ailoot grok-imagine-video
ชื่อพาธเมธอดอื่น
ใช้พาธเมธอดที่แสดงด้านบน
ID ที่เกี่ยวข้องสำหรับเรียกใช้โมเดล
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