Gemini Omni 1.1 Flash API

Tài liệu tham khảo API đầy đủ cho các mô hình tạo video Google Gemini Omni 1.1 Flash.

Các biến thể mô hình

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

So sánh nhanh

Endpoint dùng chung

Tất cả biến thể Gemini Omni 1.1 Flash đều sử dụng endpoint tác vụ video:

POST /api/v1/video/task

Gemini Omni 1.1 Flash Text to Video

Tham số bắt buộc

Yêu cầu mẫ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: 'gemini-omni-1.1-flash-text-to-video',
    prompt: 'A cinematic tracking shot follows a sailboat crossing a glowing ocean at sunset',
    aspect_ratio: '16:9',
    resolution: '1080p',
    duration: 8
  })
});

const { data } = await response.json();
const taskId = data.task_id;

Gemini Omni 1.1 Flash Image to Video

Tham số bắt buộc

Tham số tùy chọn

Yêu cầu mẫu

javascriptSao chép
{
  model_name: 'gemini-omni-1.1-flash-image-to-video',
  prompt: 'The girl walks toward the camera while the city lights shimmer behind her',
  image_url: 'https://example.com/start-frame.jpg',
  image_end_url: 'https://example.com/end-frame.jpg',
  aspect_ratio: '9:16',
  resolution: '1080p',
  duration: 8
}

Gemini Omni 1.1 Flash Video Edit

Tham số bắt buộc

Lưu ý: Video Edit không hỗ trợ aspect_ratio hoặc duration. Không đưa bất kỳ tham số nào trong hai tham số này vào yêu cầu.

Yêu cầu mẫu

javascriptSao chép
{
  model_name: 'gemini-omni-1.1-flash-video-edit',
  prompt: 'A small ball rolls into the scene and captures the attention of the cat',
  video_url: 'https://example.com/source-video.mp4',
  resolution: '1080p'
}

Gemini Omni 1.1 Flash Reference to Video

Hình ảnh và video tham chiếu là tùy chọn, có thể được sử dụng riêng biệt hoặc kết hợp với nhau.

Tham số bắt buộc

Đầu vào tham chiếu tùy chọn

Yêu cầu mẫu

javascriptSao chép
{
  model_name: 'gemini-omni-1.1-flash-reference-to-video',
  prompt: 'Use the references to create a cinematic shot of a small boat approaching from the distance',
  aspect_ratio: '16:9',
  resolution: '1080p',
  duration: 8,
  images: ['https://example.com/boat-reference.jpg'],
  videos: ['https://example.com/motion-reference.mp4']
}

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

Phản hồi ban đầu

Tất cả mô hình đều trả về task_id để thăm dò 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": "submitted"
  }
}

Phản hồi thăm dò

Thăm dò 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: Quá trình tạo video đang diễn ra
• succeed: Quá trình tạo video đã hoàn tất
• failed: Quá trình tạo video thất bại

Phương pháp hay nhất

1. Định hướng câu lệnh: Mô tả rõ chủ thể, hành động, chuyển động của camera, ánh sáng và diễn tiến của cảnh.
2. Cài đặt bắt buộc: Luôn cung cấp độ phân giải được hỗ trợ và, ngoại trừ Video Edit, cung cấp tỷ lệ khung hình và thời lượng được hỗ trợ.
3. Đầu vào hình ảnh: Sử dụng URL ổn định, có thể truy cập công khai cho ảnh mở đầu, ảnh kết thúc và ảnh tham chiếu.
4. Đầu vào Video Edit: Xác minh video nguồn có thời lượng từ 3 đến 10 giây trước khi gửi.
5. Giới hạn tham chiếu: Gửi không quá 10 hình ảnh và 3 video, đồng thời giữ thời lượng mỗi video tham chiếu ở mức tối đa 3 giây.