Grok Imagine Video API

Tài liệu tham khảo API đầy đủ cho các mô hình tạo video Grok Imagine của xAI.

Các Biến Thể Mô Hình

API này hỗ trợ hai biến thể mô hình:

So Sánh Nhanh

Grok Imagine Text to Video

Endpoint

POST /api/v1/video/task

Tham Số Yêu Cầu

Bắt buộc

Tùy chọn

Ví Dụ Yêu Cầu

javascriptSao chép
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 Image to Video

Tham Số Yêu Cầu

Bắt buộc

Tùy chọn

Ví Dụ Yêu Cầu

javascriptSao chép
{
  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'
}

Định Dạng Phản Hồi

Phản Hồi Ban Đầu

Cả hai mô hình đều trả về task_id để polling:

jsonSao chép
{
  "code": 0,
  "message": "success",
  "data": {
    "task_id": "{task_id}",
    "response_url": "https://api.flaq.ai/api/v1/video/{task_id}",
    "task_status": "submitted"
  }
}

Phản Hồi Polling

Poll GET /api/v1/video/{taskId} để kiểm tra trạng thái:

jsonSao chép
{
  "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"
        }
      ]
    }
  }
}

Giá Trị Trạng Thái

• submitted: Tác vụ đã được gửi và đang chờ xử lý
• processing: Đang tạo video
• succeed: Tạo video hoàn tất
• failed: Tạo video thất bại

Thời Gian Xử Lý

Thời gian xử lý thông thường: 2-5 phút.

Thực Hành Tốt Nhất

1. Prompt Sáng Tạo: Grok Imagine Video hoạt động tốt nhất với các mô tả cảnh chi tiết và giàu trí tưởng tượng
2. Mô Tả Chuyển Động: Bao gồm chuyển động camera và chuyển động của đối tượng trong prompt
3. Chất Lượng Ảnh: Đối với image-to-video, hãy sử dụng ảnh đầu vào chất lượng cao