Wan 3.0 API

Tài liệu tham khảo API đầy đủ dành cho các mô hình tạo video Wan 3.0 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

Điểm cuối dùng chung

Tất cả biến thể Wan 3.0 đều sử dụng điểm cuối tác vụ video:

POST /api/v1/video/task

Tham số dùng chung

Bắt buộc

Tùy chọn

Wan 3.0 Text to Video

Đặt model_name thành "wan-3.0-text-to-video" và cung cấp các tham số bắt buộc dùng chung.

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: 'wan-3.0-text-to-video',
    prompt: 'A cinematic tracking shot follows a cyclist through a rain-soaked neon city at night',
    duration: 8,
    resolution: '1080p',
    aspect_ratio: '16:9',
    sound: true,
    seed: 42
  })
});

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

Wan 3.0 Image to Video

Đầu vào hình ảnh bắt buộc

Cả hai hình ảnh phải có định dạng JPEG, JPG, PNG không có kênh alpha, BMP hoặc WEBP. Mỗi chiều của hình ảnh phải từ 240 đến 8000 pixel.

Yêu cầu mẫu

javascriptSao chép
{
  model_name: 'wan-3.0-image-to-video',
  prompt: 'The camera glides forward as daylight gradually shifts into a warm evening glow',
  image_url: 'https://example.com/start-frame.jpg',
  image_end_url: 'https://example.com/end-frame.jpg',
  duration: 8,
  resolution: '1080p',
  aspect_ratio: '16:9',
  sound: true,
  seed: 42
}

Wan 3.0 Video Edit

Đầu vào video bắt buộc

Thời lượng video nguồn cộng với duration đầu ra được yêu cầu không được vượt quá 30 giây.

Yêu cầu mẫu

javascriptSao chép
{
  model_name: 'wan-3.0-video-edit',
  prompt: 'Turn the daytime scene into a rainy evening while preserving the subject and camera movement',
  video_url: 'https://example.com/source-video.mp4',
  duration: 10,
  resolution: '1080p',
  aspect_ratio: '16:9',
  sound: true,
  seed: 42
}

Wan 3.0 Reference to Video

Đầu vào tham chiếu là tùy chọn và có thể kết hợp với nhau, ngoại trừ files và links không thể gửi cùng lúc.

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

Yêu cầu mẫu

javascriptSao chép
{
  model_name: 'wan-3.0-reference-to-video',
  prompt: 'Use the references to create a cinematic product launch with coordinated motion and sound',
  duration: 12,
  resolution: '1080p',
  aspect_ratio: '16:9',
  sound: true,
  images: ['https://example.com/product-reference.jpg'],
  videos: ['https://example.com/motion-reference.mp4'],
  audios: ['https://example.com/sound-reference.mp3'],
  links: ['https://example.com/public-creative-brief'],
  seed: 42
}

Để sử dụng tệp tham chiếu thay cho trang web, hãy bỏ qua links và truyền một URL duy nhất trong files.

Đị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: Đang tạo video
• succeed: Đã hoàn tất tạo video
• failed: Tạo video không thành công

Các 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 máy quay, nhịp độ, môi trường và ý đồ âm thanh.
2. Đầu vào hình ảnh: Sử dụng hình ảnh đầu, cuối và tham chiếu khớp với tỷ lệ khung hình được yêu cầu. Hình ảnh PNG không được chứa kênh alpha.
3. Thời lượng chỉnh sửa video: Kiểm tra thời lượng nguồn trước khi chọn thời lượng đầu ra được yêu cầu để tổng thời lượng không vượt quá 30 giây.
4. Giới hạn nội dung tham chiếu: Xác thực số lượng, định dạng, kích thước và tổng thời lượng của mọi tập hợp nội dung tham chiếu trước khi gửi.
5. Tệp và liên kết: Chỉ gửi một tệp tham chiếu hoặc một liên kết trang web công khai, không bao giờ gửi cả hai trong cùng một yêu cầu.