Happy Horse 1.0 API

Tài liệu tham chiếu API đầy đủ cho các mô hình tạo video Happy Horse 1.0 của Alibaba.

Biến Thể Mô Hình

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

So Sánh Nhanh

Tỷ Lệ Khung Hình Được Hỗ Trợ Cho Text to Video

Happy Horse 1.0 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: 'happyhorse-1.0-text-to-video',
    prompt: 'A cat playing with a ball of yarn on a sunny windowsill',
    duration: 5,
    resolution: '1080p',
    aspect_ratio: '16:9',
    seed: 42,
  }),
});

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

Happy Horse 1.0 Image to Video

Tham Số Yêu Cầu

Bắt buộc

Tùy chọn

Yêu Cầu Đối Với Ảnh Đầu Vào

• Định dạng được hỗ trợ: JPEG, JPG, PNG, BMP, WEBP
• Khoảng tỷ lệ khung hình được hỗ trợ: từ 1:2.5 đến 2.5:1
• Kích thước tối thiểu: 300px
• Không có giới hạn độ phân giải tối đa rõ ràng
• Khung hình đầu ra sẽ bám theo bố cục của ảnh đã tải lê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: 'happyhorse-1.0-image-to-video',
    image_url: 'https://example.com/first-frame.jpg',
    prompt: 'Gentle motion; cinematic lighting',
    duration: 5,
    resolution: '1080p',
    seed: 42,
  }),
});

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

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

Phản Hồi Ban Đầu

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 chấp nhận và đang chờ xử lý
• processing: Quá trình tạo video đang diễn ra
• 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, tùy thuộc vào thời lượng và tải hàng đợi.

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

1. Mô tả chuyển động rõ ràng: Thêm chuyển động của chủ thể, chuyển động máy quay và diễn tiến cảnh để cải thiện độ sống động của video.
2. Dùng các lần thử ngắn trước: Bắt đầu với video 3-5 giây để xác nhận hướng prompt trước khi chạy các clip dài hơn.
3. Chọn ảnh đầu vào phù hợp: Với image-to-video, hãy dùng ảnh rõ nét, đủ sáng và có chủ thể nổi bật.
4. Tái sử dụng Seed cho các biến thể: Giữ cùng một seed khi thử tinh chỉnh prompt để so sánh kết quả nhất quán hơn.
5. Khớp tỷ lệ với kênh phân phối: Dùng 16:9 cho video ngang, 9:16 cho shorts và reels, và 1:1 cho bố cục vuông.