واجهة API لـ Grok Imagine Video
مرجع API كامل لنماذج Grok Imagine Video generation من xAI.
متغيرات النموذج
تدعم واجهة API هذه متغيرين من النماذج:
مقارنة سريعة
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 للاستطلاع:
{
"code": 0,
"message": "success",
"data": {
"task_id": "{task_id}",
"response_url": "https://api.flaq.ai/api/v1/video/{task_id}",
"task_status": "submitted"
}
}
استجابة الاستطلاع
استطلع 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 minutes.
أفضل الممارسات
- موجهات إبداعية: Grok Imagine Video يتميز مع أوصاف المشاهد الخيالية والمفصلة
- وصف الحركة: ضمّن حركة الكاميرا وحركة الموضوع في الموجهات
- جودة الصورة: في image-to-video، استخدم صور إدخال عالية الجودة