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.

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

API này hỗ trợ hai biến thể mô hình:

So sánh nhanh

Các 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 thành bố cục

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

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

Phản hồi ban đầu

Cả hai 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 khi 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: Tác vụ đã được tiế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ý thông thường là 15–60 giây, tùy thuộc vào độ phức tạp của câu lệnh và số lượng ảnh trong yêu cầu chỉnh sửa.

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

1. Mô tả bố cục rõ ràng: ChatGPT Images 2.5 cho kết quả tốt nhất khi câu lệnh mô tả rõ chủ thể, cách đóng khung, á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, đủ sáng giúp giữ nguyên đặc điểm nhận dạng của chủ thể và nâng cao chất lượng chỉnh sửa cục bộ.
4. Chỉ dùng các ảnh tham chiếu hữu ích 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 chỉ dẫn hình ảnh mâu thuẫn.