API Qwen Image 3.0 Pro

Tài liệu tham khảo API đầy đủ cho các mô hình Qwen Image 3.0 Pro do Alibaba Qwen cung cấp.

Các 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ợ

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

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

Qwen Image 3.0 Pro (Văn bản sang hình ảnh)

Đ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ệ chiều rộng:chiều cao phải là một trong các giá trị sau: 16:9, 9:16, 1:1, 4:3, 3:4, 3:2, 2:3

Tùy chọn

Yêu cầu mẫ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: 'qwen-image-3.0-pro',
    prompt: 'A professional product photo with studio lighting',
    width: 16,
    height: 9,
    seed: 42
  })
});

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);

Qwen Image 3.0 Pro Edit (Chỉnh sửa hình ảnh)

Điểm cuối

POST /api/v1/image/task

Tham số yêu cầu

Bắt buộc

Lưu ý: Tỷ lệ chiều rộng:chiều cao phải là một trong các giá trị sau: 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 hình ảnh

javascriptSao chép
{
  model_name: 'qwen-image-3.0-pro-edit',
  prompt: 'Transform this image into a professional portrait with soft studio lighting',
  width: 16,
  height: 9,
  image_url_list: ['https://example.com/image1.jpg']
}

Ví dụ kết hợp nhiều hình ảnh

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

javascriptSao chép
{
  model_name: 'qwen-image-3.0-pro-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'
  ],
  seed: 42
}

Định dạng phản hồi

Phản hồi ban đầu

Tất cả mô hình trả về một task_id để thăm dò:

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 thăm dò

Thăm dò 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
• succeed: Đã tạo thành công
• failed: Tạo thất bại

Các phương pháp hay nhất

Mẹo chuyển văn bản thành hình ảnh

1. Hãy cụ thể: Đưa thông tin chi tiết về chủ thể, phong cách, ánh sáng và bố cục vào lời nhắc
2. Chọn tỷ lệ khung hình: Chọn tỷ lệ dựa trên trường hợp sử dụng của bạn (16:9 cho biểu ngữ web, 9:16 cho thiết bị di động, 1:1 cho mạng xã hội)
3. Sử dụng seed để tái lập: Đặ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

Mẹo chỉnh sửa hình ảnh

1. Hướng dẫn rõ ràng: Nêu cụ thể nội dung cần thay đổi trong lời nhắc
2. Kết hợp nhiều hình ảnh: Cung cấp tối đa 3 hình ảnh và mô tả cách kết hợp chúng
3. Chất lượng hình ảnh: Hình ảnh đầu vào có chất lượng cao hơn thường tạo ra kết quả chỉnh sửa tốt hơn