ChatGPT Images 2.5 API

Tài liệu tham khảo API đầy đủ cho các mô hình ChatGPT Images 2.5 Client, Flare và Sunburst.

Các biến thể mô hình

API này hỗ trợ sáu biến thể mô hình hiện có:

So sánh nhanh

Flare và Sunburst dùng chung các tùy chọn yêu cầu dưới đây. Các biến thể Client vẫn giữ các tùy chọn hiện có trong bảng thứ hai.

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

ChatGPT Images 2.5 Client (Tạo ảnh từ văn bản)

Đ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, 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: 'chatgpt-images-2.5-client',
    prompt: 'A minimalist product shot of a ceramic mug on marble, soft studio light',
    width: 1,
    height: 1,
    resolution: '1k'
  })
});

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

ChatGPT Images 2.5 Edit Client (Chỉnh sửa ả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, 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: 'chatgpt-images-2.5-edit-client',
  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'
}

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

javascriptSao chép
{
  model_name: 'chatgpt-images-2.5-edit-client',
  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: '1k'
}

ChatGPT Images 2.5 Flare (Tạo ảnh từ văn bản)

Điểm cuối

POST /api/v1/image/task

Tham số yêu cầu

Bắt buộc

Tỷ lệ chiều rộng:chiều cao phải khớp với một trong các tỷ lệ khung hình được hỗ trợ ở trên.

Tùy chọ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.5-flare',
    prompt: 'A ceramic mug on a pale stone table, warm studio lighting, minimal composition',
    width: 1,
    height: 1,
    resolution: '1k',
    quality: 'medium'
  })
});

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

ChatGPT Images 2.5 Flare Edit (Chỉnh sửa ảnh)

Điểm cuối

POST /api/v1/image/task

Tham số yêu cầu

Bắt buộc

Tỷ lệ chiều rộng:chiều cao phải khớp với một trong các tỷ lệ khung hình được hỗ trợ ở trên.

Tùy chọ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.5-flare-edit',
    prompt: 'Replace the background with a warm studio setting while keeping the product unchanged',
    image_url_list: ['https://example.com/product-photo.jpg'],
    width: 1,
    height: 1,
    resolution: '1k',
    quality: 'medium'
  })
});

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

ChatGPT Images 2.5 Sunburst (Tạo ảnh từ văn bản)

Điểm cuối

POST /api/v1/image/task

Tham số yêu cầu

Bắt buộc

Tỷ lệ chiều rộng:chiều cao phải khớp với một trong các tỷ lệ khung hình được hỗ trợ ở trên.

Tùy chọ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.5-sunburst',
    prompt: 'A ceramic mug on a pale stone table, warm studio lighting, minimal composition',
    width: 1,
    height: 1,
    resolution: '1k',
    quality: 'medium'
  })
});

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

ChatGPT Images 2.5 Sunburst Edit (Chỉnh sửa ảnh)

Điểm cuối

POST /api/v1/image/task

Tham số yêu cầu

Bắt buộc

Tỷ lệ chiều rộng:chiều cao phải khớp với một trong các tỷ lệ khung hình được hỗ trợ ở trên.

Tùy chọ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.5-sunburst-edit',
    prompt: 'Replace the background with a warm studio setting while keeping the product unchanged',
    image_url_list: ['https://example.com/product-photo.jpg'],
    width: 1,
    height: 1,
    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

Cả sáu biến thể ChatGPT Images 2.5 đều trả về task_id để truy vấn định kỳ:

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 truy vấn định kỳ

Truy vấn định kỳ 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: Đã tiếp nhận tác vụ
• 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ý thay đổi theo mô hình, thiết lập đầu ra, độ phức tạp của câu lệnh và số lượng ảnh tham chiếu. Truy vấn định kỳ cho đến khi trạng thái tác vụ là succeed hoặc failed; tác vụ đã gửi hoặc đang xử lý có thể chưa có kết quả ảnh.

Các phương pháp nên áp dụng

1. Mô tả rõ bố cục: ChatGPT Images 2.5 hoạt động tốt nhất khi câu lệnh mô tả rõ chủ thể, cách lấy khung hình, ánh sáng và phong cách mong muốn.
2. Chọn tỷ lệ khung hình phù hợp với mục đích sử dụng: Đặt tỷ lệ ngay từ đầu cho bài đăng mạng xã hội, biểu ngữ, trang sản phẩm hoặc bố cục biên tập.
3. Dùng ảnh nguồn rõ nét để chỉnh sửa: Ảnh đầu vào sắc nét và đủ sáng giúp giữ nguyên đặc điểm nhận diện của chủ thể và cải thiện chất lượng chỉnh sửa cục bộ.
4. Chỉ dùng ảnh tham chiếu phù hợp trong yêu cầu nhiều ảnh: Với yêu cầu chỉnh sửa, chỉ cung cấp những ảnh cần thiết để tránh các hướng dẫn hình ảnh mâu thuẫn nhau.