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 Standard và Pro do Alibaba Qwen cung cấp.

Các phiên bản mô hình

API này hỗ trợ bốn phiên bản mô hình:

So sánh nhanh

Tỷ lệ khung hình được hỗ trợ

Cả bốn mô hình đều hỗ trợ các tỷ lệ khung hình sau:

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

Endpoint

POST /api/v1/image/task

Xác thực

Authorization: Bearer YOUR_API_KEY

Tạo hình ảnh từ văn bản

Sử dụng qwen-image-3.0 cho mô hình Standard hoặc qwen-image-3.0-pro cho mô hình Pro.

Tham số yêu cầu

Bắt buộc

Tỷ lệ chiều rộng trên 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ụ yêu cầu Standard

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',
    prompt: 'A professional product photo with soft studio lighting',
    width: 16,
    height: 9,
    resolution: '1k',
    seed: 42
  })
});

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

Ví dụ yêu cầu Pro

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 detailed editorial product scene with precise typography and cinematic lighting',
    width: 16,
    height: 9,
    resolution: '2k',
    seed: 42
  })
});

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

Chỉnh sửa hình ảnh

Sử dụng qwen-image-3.0-edit cho mô hình Standard Edit hoặc qwen-image-3.0-pro-edit cho mô hình Pro Edit.

Tham số yêu cầu

Bắt buộc

Tỷ lệ chiều rộng trên 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ụ yêu cầu Standard Edit

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-edit',
    prompt: 'Transform the input into a polished editorial portrait with soft studio lighting',
    width: 16,
    height: 9,
    resolution: '1k',
    image_url_list: ['https://example.com/image1.jpg'],
    seed: 42
  })
});

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

Ví dụ yêu cầu nhiều hình ảnh Pro Edit

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-edit',
    prompt: 'Combine the products from these references into one cohesive campaign image',
    width: 16,
    height: 9,
    resolution: '2k',
    image_url_list: [
      'https://example.com/image1.jpg',
      'https://example.com/image2.jpg',
      'https://example.com/image3.jpg'
    ],
    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

Tất 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

Polling GET /api/v1/image/{task_id} để kiểm tra trạng thái tác vụ:

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"
}

Giá trị trạng thái

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

Phương pháp hay nhất

Mẹo tạo hình ảnh từ văn bản

1. Mô tả cụ thể: Bao gồm chủ thể, phong cách, ánh sáng, bố cục và yêu cầu văn bản trong prompt.
2. Chọn độ phân giải: Chọn 1k hoặc 2k dựa trên độ phân giải đầu ra cần thiết.
3. Chọn tỷ lệ khung hình: Chọn tỷ lệ phù hợp với đích sử dụng, chẳng hạn 16:9 cho banner hoặc 9:16 cho nội dung dọc.
4. Sử dụng Seed để tái lập: Đặt seed cố định khi cần các thiết lập tạo hình có thể lặp lại.

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

1. Sử dụng chỉ dẫn rõ ràng: Mô tả nội dung cần thay đổi và nội dung cần giữ nhất quán.
2. Sắp xếp nhiều đầu vào có chủ đích: Cung cấp 1–3 hình ảnh và giải thích vai trò của từng hình ảnh tham chiếu trong prompt.
3. Chọn độ phân giải đầu ra: Chọn 1k hoặc 2k độc lập với kích thước hình ảnh đầu vào.
4. Sử dụng đầu vào chất lượng cao: Hình ảnh nguồn rõ nét thường giúp kiểm soát kết quả chỉnh sửa tốt hơn.