Wan 2.7 API

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

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

Wan 2.7 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: 'wan-2.7-text-to-video',
    prompt: 'A cat playing with a ball of yarn in a sunlit room',
    duration: 6,
    resolution: '720p',
    aspect_ratio: '16:9',
    negative_prompt: 'blur, low quality',
    seed: 42
  })
});

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

Wan 2.7 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: 'wan-2.7-image-to-video',
  image_url: 'https://example.com/first-frame.jpg',
  image_end_url: 'https://example.com/last-frame.jpg',
  video_url: 'https://example.com/reference-continuation.mp4',
  audio_url: 'https://example.com/driving-audio.mp3',
  prompt: 'Gentle camera push-in; leaves rustle softly in the breeze',
  duration: 6,
  resolution: '720p',
  negative_prompt: 'blur, low quality',
  seed: 42
}

Wan 2.7 Video Edit

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: 'wan-2.7-video-edit',
  prompt: 'Replace the sky with warm sunset colors, keep subjects natural',
  negative_prompt: 'artifacts, flicker',
  seed: 42,
  video_url: 'https://example.com/source.mp4',
  images: ['https://example.com/ref-a.jpg', 'https://example.com/ref-b.jpg'],
  audio_setting: 'auto'
}

Wan 2.7 Tham Chiếu Thành Video

Tạo video mới từ các tham chiếu hình ảnh và video theo thứ tự, với hướng dẫn giọng nói tùy chọn từ một đoạn âm thanh.

Tham Số Yêu Cầu

Bắt Buộc

Phương Tiện Tham Chiếu

Cần có ít nhất một hình ảnh hoặc video tham chiếu. Tổng số phần tử trong images và videos không được vượt quá 5.

Tùy Chọn

Placeholder Tham Chiếu @ (AT)

Tính năng tham chiếu @ (AT) liên kết phương tiện tham chiếu với prompt thông qua các placeholder <<<...>>> được đánh số. Số thứ tự bắt đầu từ 1 độc lập cho từng loại phương tiện và tuân theo thứ tự của mảng tương ứng.

Ví Dụ Yêu Cầu

javascriptSao chép
{
  model_name: 'wan-2.7-reference-to-video',
  prompt: 'Use image one for the hero and video one for the motion; keep the hero voice consistent with audio one',
  resolution: '1080p',
  duration: 8,
  aspect_ratio: '16:9',
  images: ['https://example.com/hero-reference.jpg'],
  videos: ['https://example.com/motion-reference.mp4'],
  audios: ['https://example.com/voice-reference.mp3'],
  negative_prompt: 'flicker, distorted hands, duplicate subjects',
  seed: 42
}

Ví Dụ Yêu Cầu Reference-to-Video @ (AT)

javascriptSao chép
{
  model_name: 'wan-2.7-reference-to-video',
  prompt: 'Place the presenter from <<<image_1>>> in the studio from <<<image_2>>>, follow the camera path in <<<video_1>>>, and use the reference voice from <<<audio_1>>>',
  resolution: '1080p',
  duration: 8,
  aspect_ratio: '16:9',
  images: [
    'https://example.com/presenter-reference.jpg',
    'https://example.com/studio-reference.jpg'
  ],
  videos: ['https://example.com/camera-path-reference.mp4'],
  audios: ['https://example.com/voice-reference.mp3'],
  negative_prompt: 'flicker, distorted hands, duplicate subjects',
  seed: 42
}

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

Phản Hồi Ban Đầu

Tất cả các mô hình 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

Thực hiện polling tại 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"
        }
      ]
    }
  }
}

Các Giá Trị Trạng Thái

• submitted: Tác vụ đã được gửi 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 cài đặt thời lượng và độ phân giải.

Video dài hơn (10-15 giây) ở độ phân giải 1080p có thể mất đến 8 phút.

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

1. Mô tả Cảnh & Chuyển động: Bao gồm cả nội dung cảnh quay và chuyển động máy ảnh trong prompt
2. Lựa chọn Độ phân giải: Dùng 720p để xử lý nhanh hơn, 1080p để đạt chất lượng cao nhất
3. Lập kế hoạch Thời lượng: Video dài hơn có chi phí cao hơn (tính giá theo giây)
4. Tích hợp Âm thanh: Thêm âm thanh tùy chỉnh thông qua tham số audio_url
5. Chất lượng Hình ảnh: Đối với image-to-video, sử dụng hình ảnh đầu vào chất lượng cao để đạt kết quả tốt nhất
6. Prompt Video Edit: Mô tả cụ thể những gì cần thay đổi và những gì cần giữ nguyên
7. Số lượng tài nguyên tham chiếu: Với Reference-to-Video, tổng số phần tử trong images và videos không được vượt quá 5
8. Giọng nói tham chiếu: Chỉ dùng audios để hướng dẫn đặc điểm giọng nói và mô tả nội dung lời nói mong muốn trong prompt