Flux Kontext Max API

Tài liệu tham chiếu API đầy đủ cho Flux Kontext Max với khả năng hiểu ngữ cảnh đa hình ảnh nâng cao.

Tổng quan mô hình

So sánh nhanh

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

Cả hai chế độ đều hỗ trợ 9 tỷ lệ khung hình:

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

Chi phí

Flux Kontext Max (Văn bản sang hình ảnh)

Endpoint

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ị: "1:1", "16:9", "9:16", "3:2", "2:3", "4:3", "3:4", "21:9", "9:21"

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: 'flux-kontext-max',
    prompt: 'A futuristic cityscape at night with neon lights',
    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);

Flux Kontext Max (Hình ảnh sang hình ảnh)

Endpoint

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ị: "1:1", "16:9", "9:16", "3:2", "2:3", "4:3", "3:4", "21:9", "9:21"

Ví dụ chỉnh sửa một hình ảnh

javascriptSao chép
{
  model_name: 'flux-kontext-max',
  prompt: 'Enhance this portrait with cinematic lighting',
  width: 3,
  height: 4,
  image_url_list: ['https://example.com/portrait.jpg']
}

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

javascriptSao chép
{
  model_name: 'flux-kontext-max',
  prompt: 'Merge these architectural photos into a unified panorama',
  width: 21,
  height: 9,
  image_url_list: ['https://example.com/arch1.jpg', 'https://example.com/arch2.jpg', 'https://example.com/arch3.jpg']
}

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

Phản hồi ban đầu

Cả hai chế độ đều trả về 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ò /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.08,
      "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 ảnh
• succeed: Tạo ảnh thành công
• failed: Tạo ảnh thất bại

Xử lý lỗi

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: 1:1, 16:9, 9:16, 3:2, 2:3, 4:3, 3:4, 21:9, 9:21"
}

Thiếu URL hình ảnh (chế độ hình ảnh sang hình ảnh)

jsonSao chép
{
  "code": 400,
  "message": "image_url_list is required for flux-kontext-max"
}

Quá nhiều hình ảnh

jsonSao chép
{
  "code": 400,
  "message": "Maximum 5 images allowed"
}

Thực hành tốt nhất

Mẹo văn bản sang hình ảnh

1. Prompt chi tiết: Cung cấp mô tả rõ ràng, chi tiết để có kết quả tốt nhất
2. Tỷ lệ khung hình: Chọn tỷ lệ khung hình phù hợp cho trường hợp sử dụng của bạn
3. Cảnh phức tạp: Flux Kontext Max vượt trội với các cảnh phức tạp, nhiều chi tiết
4. Thăm dò hiệu quả: Kiểm tra trạng thái mỗi 2-3 giây

Mẹo hình ảnh sang hình ảnh

1. Nhận biết ngữ cảnh: Tận dụng đầu vào đa hình ảnh để tạo nội dung giàu ngữ cảnh
2. Đầu vào chất lượng cao: Sử dụng hình ảnh nguồn độ phân giải cao để có kết quả tốt nhất
3. Mục tiêu biến đổi rõ ràng: Mô tả chính xác kết quả mong muốn
4. Sức cộng hưởng đa hình ảnh: Kết hợp tối đa 5 hình ảnh cho các bố cục phức tạp

Ví dụ trường hợp sử dụng

Nhiếp ảnh sản phẩm cao cấp

javascriptSao chép
{
  model_name: 'flux-kontext-max',
  prompt: 'Ultra-realistic product shot of diamond jewelry on black velvet',
  width: 4,
  height: 3
}

Trực quan hóa kiến trúc

javascriptSao chép
{
  model_name: 'flux-kontext-max',
  prompt: 'Modern minimalist interior with natural lighting',
  width: 16,
  height: 9
}

Toàn cảnh đa hình ảnh

javascriptSao chép
{
  model_name: 'flux-kontext-max',
  image_url_list: ['view1.jpg', 'view2.jpg', 'view3.jpg', 'view4.jpg'],
  prompt: 'Seamless 360-degree panorama of mountain landscape',
  width: 21,
  height: 9
}

Chuyển đổi phong cách nâng cao

javascriptSao chép
{
  model_name: 'flux-kontext-max',
  image_url_list: ['photo.jpg'],
  prompt: 'Transform into oil painting with Van Gogh style brushwork',
  width: 1,
  height: 1
}