Grok Imagine Video API
เอกสารอ้างอิง API ฉบับสมบูรณ์สำหรับโมเดลสร้างวิดีโอ Grok Imagine Video โดย xAI.
ตัวเลือกโมเดล {#}
API นี้รองรับโมเดล 2 ตัวเลือก:
เปรียบเทียบอย่างรวดเร็ว
Grok Imagine ข้อความเป็นวิดีโอ
จุดเชื่อมต่อ
POST /api/v1/video/task
พารามิเตอร์คำขอ
จำเป็น
ไม่บังคับ
ตัวอย่างคำขอ
const response = await fetch('https://api.flaq.ai/api/v1/video/task', {
method: 'POST',
headers: {
'Authorization': 'Bearer YOUR_API_KEY',
'Content-Type': 'application/json'
},
body: JSON.stringify({
model_name: 'grok-imagine-text-to-video',
prompt: 'A robot walking through a futuristic city',
duration: 6,
resolution: '720p',
aspect_ratio: '16:9'
})
});
const { data } = await response.json();
const taskId = data.task_id;
Grok Imagine รูปภาพเป็นวิดีโอ
พารามิเตอร์คำขอ
จำเป็น
ไม่บังคับ
ตัวอย่างคำขอ
{
model_name: 'grok-imagine-image-to-video',
images: ['https://example.com/reference.jpg'],
prompt: 'Camera slowly zooms in on the subject',
duration: 6,
resolution: '720p'
}
รูปแบบการตอบกลับ
การตอบกลับเริ่มต้น
ทั้งสองโมเดลส่งคืน task_id สำหรับการ Poll:
{
"code": 0,
"message": "success",
"data": {
"task_id": "{task_id}",
"response_url": "https://api.flaq.ai/api/v1/video/{task_id}",
"task_status": "submitted"
}
}
การตอบกลับจากการ Poll
Poll GET /api/v1/video/{taskId} เพื่อตรวจสอบสถานะ:
{
"code": 0,
"message": "success",
"data": {
"task_id": "{task_id}",
"response_url": "https://api.flaq.ai/api/v1/video/{task_id}",
"task_status": "succeed",
"task_status_msg": null,
"task_result": {
"credit": 0.2,
"videos": [
{
"url": "https://example.com/generated-video.mp4"
}
]
}
}
}
ค่าสถานะ
submitted: รับงานแล้วและรอประมวลผลprocessing: กำลังสร้างวิดีโอsucceed: การสร้างวิดีโอเสร็จสมบูรณ์failed: การสร้างวิดีโอล้มเหลว
เวลาประมวลผล
เวลาประมวลผลโดยทั่วไป: 2-5 นาที.
แนวทางปฏิบัติที่ดี
- พรอมต์เชิงสร้างสรรค์: Grok Imagine Video ทำได้ดีเมื่อใช้คำอธิบายฉากที่มีจินตนาการและละเอียด
- คำอธิบายการเคลื่อนไหว: ใส่การเคลื่อนไหวของกล้องและวัตถุในพรอมต์
- คุณภาพรูปภาพ: สำหรับ image-to-video ให้ใช้รูปภาพอินพุตคุณภาพสูง