API Grok Imagine Video 1.5

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

Biến thể mô hình

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

Tỷ lệ khung hình được hỗ trợ

Tùy chọn độ phân giải

Grok Imagine 1.5 Image 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-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;

Ví dụ chỉ body:

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

Định dạng phản hồi

Phản hồi ban đầ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

Polling 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 chấp nhận 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ý điển hình: 2-5 phút.

Phương pháp hay nhất

1. Mô tả chuyển động: Bao gồm chuyển động camera và chuyển động chủ thể trong prompt
2. Chất lượng hình ảnh: Sử dụng ảnh đầu vào chất lượng cao để có kết quả hoạt ảnh tốt hơn
3. Tỷ lệ khung hình: Khớp aspect_ratio với định dạng đầu ra mục tiêu trước khi gửi