API Grok Imagine Video 1.5
เอกสารอ้างอิง API ฉบับสมบูรณ์สำหรับโมเดลสร้าง Grok Imagine Video 1.5 โดย xAI
รุ่นย่อยของโมเดล {#}
API นี้รองรับรุ่นย่อยของโมเดลหนึ่งรุ่น:
อัตราส่วนภาพที่รองรับ
ตัวเลือกความละเอียด
Grok Imagine 1.5 Image to Video
Endpoint
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-v1.5-image-to-video',
image_url: 'https://example.com/reference.jpg',
prompt: 'Subtle camera motion, subject holds pose',
aspect_ratio: '16:9',
duration: 10,
resolution: '720p'
})
});
const { data } = await response.json();
const taskId = data.task_id;
ตัวอย่างเฉพาะ body:
{
model_name: 'grok-imagine-v1.5-image-to-video',
image_url: 'https://example.com/reference.jpg',
prompt: 'Subtle camera motion, subject holds pose',
aspect_ratio: '16:9',
duration: 10,
resolution: '720p'
}
รูปแบบการตอบกลับ
การตอบกลับเริ่มต้น
ส่งคืน task_id สำหรับการ polling:
{
"code": 0,
"message": "success",
"data": {
"task_id": "{task_id}",
"response_url": "https://api.flaq.ai/api/v1/video/{task_id}",
"task_status": "submitted"
}
}
การตอบกลับจากการ polling
Polling 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": {
"videos": [
{
"url": "https://example.com/generated-video.mp4"
}
]
}
}
}
ค่าสถานะ
submitted: รับงานแล้วและกำลังรอประมวลผลprocessing: กำลังสร้างวิดีโอsucceed: สร้างวิดีโอเสร็จสมบูรณ์failed: การสร้างวิดีโอล้มเหลว
เวลาประมวลผล
เวลาประมวลผลโดยทั่วไป: 2-5 นาที
แนวทางปฏิบัติที่ดี
- คำอธิบายการเคลื่อนไหว: ใส่การเคลื่อนไหวของกล้องและการเคลื่อนไหวของตัวแบบในพรอมต์
- คุณภาพของภาพ: ใช้ภาพอินพุตคุณภาพสูงเพื่อผลลัพธ์แอนิเมชันที่ดีขึ้น
- อัตราส่วนภาพ: จับคู่
aspect_ratio กับรูปแบบเอาต์พุตเป้าหมายก่อนส่ง