Flux Kontext Pro API

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

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 Pro (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-pro',
    prompt: 'A serene mountain landscape 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);

Flux Kontext Pro (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-pro',
  prompt: 'Transform this photo into a watercolor painting',
  width: 16,
  height: 9,
  image_url_list: ['https://example.com/image.jpg']
}

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

javascriptSao chép
{
  model_name: 'flux-kontext-pro',
  prompt: 'Combine these images into a cohesive landscape scene',
  width: 16,
  height: 9,
  image_url_list: ['https://example.com/image1.jpg', 'https://example.com/image2.jpg', 'https://example.com/image3.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.04,
      "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-pro"
}

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. Hãy cụ thể: Bao gồm chủ thể, phong cách, ánh sáng và chi tiết bố cụ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 web, 9:16 cho di động)
3. Chất lượng prompt: Prompt càng chi tiết thường tạo ra kết quả càng tố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. Hướng dẫn rõ ràng: Hãy cụ thể về biến đổi mong muốn
2. Ngữ cảnh đa hình ảnh: Có thể kết hợp tối đa 5 hình ảnh để tạo nội dung nhận biết ngữ cảnh
3. Định hướng prompt: Mô tả kết quả mong muốn, không chỉ các thay đổi
4. Chất lượng hình ảnh: Hình ảnh đầu vào chất lượng cao hơn tạo ra kết quả tốt hơn

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

Nhiếp ảnh sản phẩm

javascriptSao chép
{
  model_name: 'flux-kontext-pro',
  prompt: 'Professional product shot of luxury watch on marble surface',
  width: 4,
  height: 3
}

Ảnh ghép đa hình ảnh

javascriptSao chép
{
  model_name: 'flux-kontext-pro',
  image_url_list: ['photo1.jpg', 'photo2.jpg', 'photo3.jpg'],
  prompt: 'Create a seamless collage with these vacation photos',
  width: 16,
  height: 9
}

Chuyển đổi phong cách

javascriptSao chép
{
  model_name: 'flux-kontext-pro',
  image_url_list: ['photo.jpg'],
  prompt: 'Transform into impressionist painting style',
  width: 1,
  height: 1
}