Wan 2.7 Image API

Tài liệu tham khảo API đầy đủ cho các mô hình Wan 2.7 Image được cung cấp bởi Alibaba Wan.

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

Tỷ Lệ Khung Hình Được Hỗ Trợ

Cả mô hình Standard và Pro đều hỗ trợ 7 tỷ lệ khung hình:

• 16:9, 9:16, 1:1, 4:3, 3:4, 3:2, 2:3

Wan 2.7 Image (Text-to-Image)

Điểm cuối

POST /api/v1/image/task

Xác Thực

Authorization: Bearer YOUR_API_KEY

Tham Số Yêu Cầu

Bắt buộc

Lưu ý: Tỷ lệ width:height phải là một trong các giá trị: 16:9, 9:16, 1:1, 4:3, 3:4, 3:2, 2:3

Tùy chọn

Ví Dụ Yêu Cầu

javascriptSao chép
const response = await fetch('https://api.flaq.ai/api/v1/image/task', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    model_name: 'wan-v2.7-image',
    prompt: 'A serene landscape with mountains and a lake at sunset',
    width: 16,
    height: 9
  })
});

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

// Poll for results
const pollResponse = await fetch(
  `https://api.flaq.ai/api/v1/image/${taskId}`,
  {
    headers: { 'Authorization': 'Bearer YOUR_API_KEY' }
  }
);

const result = await pollResponse.json();
console.log(result.data.task_result.images[0].url);

Wan 2.7 Image Edit (Chỉnh Sửa Ảnh)

Điểm cuối

POST /api/v1/image/task

Tham Số Yêu Cầu

Bắt buộc

Lưu ý: Tỷ lệ width:height phải là một trong các giá trị: 16:9, 9:16, 1:1, 4:3, 3:4, 3:2, 2:3

Tùy chọn

Ví Dụ Chỉnh Sửa Một Ảnh

javascriptSao chép
{
  model_name: 'wan-v2.7-image-edit',
  prompt: 'Change the background to a beach scene',
  width: 16,
  height: 9,
  image_url_list: ['https://example.com/image.jpg']
}

Ví Dụ Kết Hợp Nhiều Ảnh

Có thể kết hợp tối đa 9 ảnh trong một yêu cầu:

javascriptSao chép
{
  model_name: 'wan-v2.7-image-edit',
  prompt: 'Combine these images into a cohesive landscape',
  width: 16,
  height: 9,
  image_url_list: [
    'https://example.com/image1.jpg',
    'https://example.com/image2.jpg',
    'https://example.com/image3.jpg'
  ]
}

Wan 2.7 Image Pro (Text-to-Image)

Sử dụng cùng các tham số như Wan 2.7 Image, với model_name được đặt thành wan-v2.7-image-pro để có chất lượng đầu ra nâng cao.

Ví Dụ Yêu Cầu

javascriptSao chép
const response = await fetch('https://api.flaq.ai/api/v1/image/task', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    model_name: 'wan-v2.7-image-pro',
    prompt: 'A professional product photo with studio lighting',
    width: 16,
    height: 9
  })
});

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

Wan 2.7 Image Pro Edit (Chỉnh Sửa Ảnh)

Sử dụng cùng các tham số như Wan 2.7 Image Edit, với model_name được đặt thành wan-v2.7-image-pro-edit để có chất lượng đầu ra nâng cao.

Ví Dụ Yêu Cầu

javascriptSao chép
const response = await fetch('https://api.flaq.ai/api/v1/image/task', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    model_name: 'wan-v2.7-image-pro-edit',
    prompt: 'Replace the background with a modern office interior',
    width: 16,
    height: 9,
    image_url_list: ['https://example.com/image.jpg']
  })
});

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

Đị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 để polling:

jsonSao chép
{
  "code": 0,
  "data": {
    "task_id": "{task_id}",
    "task_status": "submitted",
    "response_url": "https://api.flaq.ai/api/v1/image/{task_id}"
  },
  "message": "success"
}

Phản Hồi Polling

Gọi GET /api/v1/image/{taskId} để kiểm tra trạng thái:

jsonSao chép
{
  "code": 0,
  "data": {
    "task_id": "{task_id}",
    "task_status": "succeed",
    "task_status_msg": null,
    "response_url": "https://api.flaq.ai/api/v1/image/{task_id}",
    "task_result": {
      "credit": 0.0997,
      "images": [
        {
          "url": "https://example.com/generated-image.jpeg"
        }
      ]
    }
  },
  "message": "success"
}

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

• submitted: Tác vụ đã được chấp nhận
• processing: Đang tạo ảnh
• succeed: Tạo ảnh hoàn thành thành công
• failed: Tạo ảnh thất bại

Xử Lý Lỗi

Các Lỗi Thường Gặp

Tỷ lệ khung hình không hợp lệ

jsonSao chép
{
  "code": 400,
  "message": "Ratio must be one of: 16:9, 9:16, 1:1, 4:3, 3:4, 3:2, 2:3"
}

Thiếu URL ảnh (Chế độ Edit)

jsonSao chép
{
  "code": 400,
  "message": "image_url_list is required for edit models"
}

Quá nhiều ảnh (Chế độ Edit)

jsonSao chép
{
  "code": 400,
  "message": "image_url_list supports a maximum of 9 images"
}

Không được phép

jsonSao chép
{
  "code": 401,
  "message": "Invalid or missing API key"
}

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

Mẹo Cho Text-to-Image

1. Hãy cụ thể: Bao gồm chủ thể, phong cách, ánh sáng và chi tiết bố cục trong prompt của bạn
2. Lựa chọn tỷ lệ khung hình: Chọn tỷ lệ phù hợp với trường hợp sử dụng của bạn (16:9 cho banner web, 9:16 cho di động, 1:1 cho mạng xã hội)
3. Sử dụng Seed để tái tạo: Đặt giá trị seed cố định khi bạn cần kết quả nhất quán giữa các yêu cầu
4. Standard vs Pro: Dùng Standard cho quy trình khối lượng lớn; dùng Pro khi chất lượng đầu ra là ưu tiên

Mẹo Cho Chỉnh Sửa Ảnh

1. Hướng dẫn rõ ràng: Hãy cụ thể về những gì cần thay đổi trong prompt
2. Kết hợp nhiều ảnh: Cung cấp tối đa 9 ảnh và mô tả cách chúng nên được kết hợp
3. Hướng dẫn prompt: Mô tả kết quả mong muốn thay vì chỉ liệt kê các thay đổi
4. Chất lượng ảnh: Ảnh đầu vào có chất lượng cao hơn thường cho kết quả chỉnh sửa tốt hơn