GPT Image 2 API

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

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ợ

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

GPT Image 2 (Tạo ảnh từ văn bản)

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

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: 'gpt-image-2',
    prompt: 'A minimalist product shot of a ceramic mug on marble, soft studio light',
    width: 1,
    height: 1,
    resolution: '1k',
    quality: 'medium'
  })
});

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

GPT Image 2 Edit (Chỉnh sửa ảnh)

Endpoint

POST /api/v1/image/task

Tham số yêu cầu

Bắt buộc

Tùy chọn

Lưu ý: Khi cung cấp width và height, tỷ lệ phải là một trong các giá trị sau: 16:9, 9:16, 1:1, 3:2, 2:3, 3:4, 4:3, 5:4, 4:5, 21:9

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

javascriptSao chép
{
  model_name: 'gpt-image-2-edit',
  prompt: 'Replace the background with a clean studio scene and brighten the product lighting',
  image_url_list: ['https://example.com/product-photo.jpg'],
  width: 16,
  height: 9,
  resolution: '1k',
  quality: 'medium'
}

Ví dụ phối hợp nhiều ảnh

javascriptSao chép
{
  model_name: 'gpt-image-2-edit',
  prompt: 'Blend these reference images into a polished campaign composition while keeping the main subject identity consistent',
  image_url_list: [
    'https://example.com/image1.jpg',
    'https://example.com/image2.jpg',
    'https://example.com/image3.jpg'
  ],
  width: 16,
  height: 9,
  resolution: '2k',
  quality: 'high'
}

GPT Image 2 Client

Sử dụng cùng tham số và năng lực như GPT Image 2, với model_name đặt thành gpt-image-2-client. Đây là biến thể trải nghiệm xem trước và có thể kém ổn định hơ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: 'gpt-image-2-client',
    prompt: 'A luxury skincare still life with soft reflections and elegant typography',
    width: 4,
    height: 5,
    resolution: '1k',
    quality: 'medium'
  })
});

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

GPT Image 2 Edit Client

Sử dụng cùng tham số và năng lực như GPT Image 2 Edit, với model_name đặt thành gpt-image-2-edit-client. Đây là biến thể trải nghiệm xem trước và có thể kém ổn định hơ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: 'gpt-image-2-edit-client',
    prompt: 'Turn this portrait into a clean editorial poster while preserving the face and pose',
    image_url_list: ['https://example.com/portrait.jpg'],
    width: 4,
    height: 5,
    resolution: '1k',
    quality: 'medium'
  })
});

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ả biến thể GPT Image 2 đề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

Poll GET /api/v1/image/{task_id} để 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"
}

Giá trị trạng thái

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

Thời gian xử lý

Thời gian xử lý điển hình là 15-60 giây, tùy thuộc vào độ phân giải, chất lượng, độ phức tạp của prompt và số lượng ảnh trong yêu cầu chỉnh sửa.

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

1. Mô tả bố cục thật rõ: GPT Image 2 hoạt động tốt nhất khi prompt mô tả rõ chủ thể, bố cục, ánh sáng và phong cách mong muốn.
2. Chọn chất lượng theo quy trình: Dùng low hoặc medium để lặp nhanh, và high cho đầu ra hoàn thiện.
3. Chọn tỷ lệ theo mục tiêu sử dụng: Hãy đặt tỷ lệ trước cho bài đăng mạng xã hội, banner, trang sản phẩm hoặc bố cục biên tập.
4. Dùng ảnh nguồn sạch cho chỉnh sửa: Ảnh đầu vào sắc nét và đủ sáng giúp giữ nhận diện và nâng chất lượng chỉnh sửa cục bộ.
5. Giới hạn yêu cầu nhiều ảnh ở các tham chiếu mạnh: Với các biến thể edit, chỉ gửi những ảnh thực sự quan trọng để tránh xung đột hướng dẫn thị giác.