Gemini Omni 1.2 Flash API

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

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

API này hỗ trợ bốn biến thể sau:

Bảng so sánh nhanh

Điểm cuối dùng chung

Tất cả các biến thể Gemini Omni 1.2 Flash đều dùng điểm cuối tác vụ video sau:

POST /api/v1/video/task

Gemini Omni 1.2 Flash Text to Video

Tham số bắt buộc

Ví dụ về 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: 'gemini-omni-1.2-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: 12
  })
});

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

Gemini Omni 1.2 Flash Image to Video

Tham số bắt buộc

Tham số tùy chọn

Ví dụ về yêu cầu

javascriptSao chép
{
  model_name: 'gemini-omni-1.2-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.2 Flash Video Edit

Tham số bắt buộc

Lưu ý: Mô hình chỉnh sửa video không hỗ trợ aspect_ratio và duration. Hãy bỏ cả hai tham số này khỏi yêu cầu.

Ví dụ về yêu cầu

javascriptSao chép
{
  model_name: 'gemini-omni-1.2-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.2 Flash Reference to Video

Có thể dùng ảnh và video tham chiếu riêng lẻ hoặc kết hợp. Phải cung cấp ít nhất một ảnh hoặc video tham chiếu trong images hoặc videos.

Tham số bắt buộc

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

Ví dụ về yêu cầu

javascriptSao chép
{
  model_name: 'gemini-omni-1.2-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: 12,
  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ả các mô hình đều trả về task_id để truy vấn trạng thái định kỳ:

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 khi truy vấn trạng thái

Gọi GET /api/v1/video/{taskId} định kỳ để 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": {
      "credit": 0.2,
      "videos": [
        {
          "url": "https://example.com/generated-video.mp4"
        }
      ]
    }
  }
}

Các giá trị trạng thái

• submitted: Tác vụ đã được tiếp nhận và đang chờ xử lý
• processing: Đang tạo video
• succeed: Đã tạo video thành công
• failed: Tạo video thất bại

Khuyến nghị khi sử dụng

1. Viết câu lệnh Mô tả rõ chủ thể, hành động, chuyển động máy quay, ánh sáng và diễn biến của cảnh.
2. Thiết lập bắt buộc Luôn chỉ định độ phân giải được hỗ trợ. Với các mô hình khác ngoài mô hình chỉnh sửa video, hãy chỉ định cả tỷ lệ khung hình và thời lượng được hỗ trợ.
3. Ảnh đầu vào Dùng URL ổn định, có thể truy cập công khai cho ảnh đầu, ảnh cuối và ảnh tham chiếu. Khi cung cấp ảnh cho khung hình cuối, hãy đặt duration trong khoảng 3–10 giây.
4. Đầu vào để chỉnh sửa video Kiểm tra để bảo đảm video nguồn không dài quá 10 giây trước khi gửi.
5. Giới hạn tư liệu tham chiếu Cung cấp ít nhất một ảnh hoặc video tham chiếu. Chỉ gửi tối đa 10 ảnh và 3 video, mỗi video tham chiếu dài không quá 3 giây.