ChatGPT Images 2.5 API

Referensi API lengkap untuk model ChatGPT Images 2.5 Client, Flare, dan Sunburst.

Varian Model

API ini mendukung enam varian model yang tersedia:

Perbandingan Singkat

Flare dan Sunburst menggunakan opsi permintaan yang sama berikut ini. Varian Client tetap menggunakan opsi yang sudah ada, seperti yang ditampilkan pada tabel kedua.

Rasio Aspek yang Didukung

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 (Teks ke Gambar)

Titik Akhir

POST /api/v1/image/task

Autentikasi

Authorization: Bearer YOUR_API_KEY

Parameter Permintaan

Wajib

Catatan: Rasio lebar:tinggi harus salah satu dari: 16:9, 9:16, 1:1, 3:2, 2:3, 3:4, 4:3, 5:4, 4:5, 21:9

Contoh Permintaan

javascriptSalin
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 (Pengeditan Gambar)

Titik Akhir

POST /api/v1/image/task

Parameter Permintaan

Wajib

Catatan: Rasio lebar:tinggi harus salah satu dari: 16:9, 9:16, 1:1, 3:2, 2:3, 3:4, 4:3, 5:4, 4:5, 21:9

Contoh Pengeditan Satu Gambar

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

Contoh Komposisi Beberapa Gambar

javascriptSalin
{
  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 (Teks ke Gambar)

Titik Akhir

POST /api/v1/image/task

Parameter Permintaan

Wajib

Rasio lebar:tinggi harus sesuai dengan salah satu rasio aspek yang didukung di atas.

Opsional

Contoh Permintaan

javascriptSalin
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 (Pengeditan Gambar)

Titik Akhir

POST /api/v1/image/task

Parameter Permintaan

Wajib

Rasio lebar:tinggi harus sesuai dengan salah satu rasio aspek yang didukung di atas.

Opsional

Contoh Permintaan

javascriptSalin
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 (Teks ke Gambar)

Titik Akhir

POST /api/v1/image/task

Parameter Permintaan

Wajib

Rasio lebar:tinggi harus sesuai dengan salah satu rasio aspek yang didukung di atas.

Opsional

Contoh Permintaan

javascriptSalin
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 (Pengeditan Gambar)

Titik Akhir

POST /api/v1/image/task

Parameter Permintaan

Wajib

Rasio lebar:tinggi harus sesuai dengan salah satu rasio aspek yang didukung di atas.

Opsional

Contoh Permintaan

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

Format Respons

Respons Awal

Keenam varian ChatGPT Images 2.5 mengembalikan task_id untuk polling:

jsonSalin
{
  "code": 0,
  "data": {
    "task_id": "{task_id}",
    "task_status": "submitted",
    "response_url": "https://api.flaq.ai/api/v1/image/{task_id}"
  },
  "message": "success"
}

Respons Polling

Lakukan polling pada GET /api/v1/image/{task_id} untuk memeriksa status:

jsonSalin
{
  "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"
}

Nilai Status

• submitted: Tugas diterima
• processing: Pembuatan atau pengeditan gambar sedang berlangsung
• succeed: Tugas berhasil diselesaikan
• failed: Tugas gagal

Waktu Pemrosesan

Waktu pemrosesan bervariasi menurut model, pengaturan keluaran, kompleksitas prompt, dan jumlah gambar referensi. Lakukan polling hingga status tugas menjadi succeed atau failed; tugas yang telah dikirim atau sedang diproses mungkin belum memiliki hasil gambar.

Praktik Terbaik

1. Jelaskan komposisi secara spesifik: ChatGPT Images 2.5 memberikan hasil terbaik jika prompt menjelaskan subjek, pembingkaian, pencahayaan, dan gaya yang diinginkan dengan jelas.
2. Sesuaikan rasio aspek dengan tujuan penggunaan: Tetapkan rasio sejak awal untuk postingan media sosial, banner, halaman produk, atau tata letak editorial.
3. Gunakan gambar sumber yang jelas untuk pengeditan: Masukan yang tajam dan memiliki pencahayaan baik meningkatkan konsistensi identitas subjek dan kualitas pengeditan lokal.
4. Batasi permintaan beberapa gambar pada referensi yang relevan: Untuk permintaan pengeditan, berikan hanya gambar yang diperlukan agar arahan visual tidak saling bertentangan.