ChatGPT Images 2.5 API

Vollständige API-Referenz für die Modelle ChatGPT Images 2.5 Client, Flare und Sunburst.

Modellvarianten

Diese API unterstützt sechs verfügbare Modellvarianten:

Kurzvergleich

Flare und Sunburst bieten die folgenden gemeinsamen Anfrageoptionen. Die Client-Varianten behalten ihre bisherigen Optionen, die in der zweiten Tabelle aufgeführt sind.

Unterstützte Seitenverhältnisse

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 (Bilderzeugung aus Text)

Endpunkt

POST /api/v1/image/task

Authentifizierung

Authorization: Bearer YOUR_API_KEY

Anfrageparameter

Erforderlich

Hinweis: Das Verhältnis Breite:Höhe muss einem der folgenden Werte entsprechen: 16:9, 9:16, 1:1, 3:2, 2:3, 3:4, 4:3, 5:4, 4:5, 21:9

Beispielanfrage

javascriptKopieren
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 (Bildbearbeitung)

Endpunkt

POST /api/v1/image/task

Anfrageparameter

Erforderlich

Hinweis: Das Verhältnis Breite:Höhe muss einem der folgenden Werte entsprechen: 16:9, 9:16, 1:1, 3:2, 2:3, 3:4, 4:3, 5:4, 4:5, 21:9

Beispiel für die Bearbeitung eines einzelnen Bildes

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

Beispiel für eine Komposition aus mehreren Bildern

javascriptKopieren
{
  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 (Bilderzeugung aus Text)

Endpunkt

POST /api/v1/image/task

Anfrageparameter

Erforderlich

Das Verhältnis Breite:Höhe muss einem der oben aufgeführten unterstützten Seitenverhältnisse entsprechen.

Optional

Beispielanfrage

javascriptKopieren
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 (Bildbearbeitung)

Endpunkt

POST /api/v1/image/task

Anfrageparameter

Erforderlich

Das Verhältnis Breite:Höhe muss einem der oben aufgeführten unterstützten Seitenverhältnisse entsprechen.

Optional

Beispielanfrage

javascriptKopieren
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 (Bilderzeugung aus Text)

Endpunkt

POST /api/v1/image/task

Anfrageparameter

Erforderlich

Das Verhältnis Breite:Höhe muss einem der oben aufgeführten unterstützten Seitenverhältnisse entsprechen.

Optional

Beispielanfrage

javascriptKopieren
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 (Bildbearbeitung)

Endpunkt

POST /api/v1/image/task

Anfrageparameter

Erforderlich

Das Verhältnis Breite:Höhe muss einem der oben aufgeführten unterstützten Seitenverhältnisse entsprechen.

Optional

Beispielanfrage

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

Antwortformat

Erste Antwort

Alle sechs Varianten von ChatGPT Images 2.5 geben eine task_id für regelmäßige Statusabfragen zurück:

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

Antwort auf die Statusabfrage

Fragen Sie GET /api/v1/image/{task_id} regelmäßig ab, um den Status zu prüfen:

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

Statuswerte

• submitted: Aufgabe angenommen
• processing: Bilderzeugung oder Bildbearbeitung läuft
• succeed: Aufgabe erfolgreich abgeschlossen
• failed: Aufgabe fehlgeschlagen

Verarbeitungszeit

Die Verarbeitungszeit hängt vom Modell, den Ausgabeeinstellungen, der Komplexität des Prompts und der Anzahl der Referenzbilder ab. Fragen Sie den Status regelmäßig ab, bis er succeed oder failed lautet; eine eingereichte oder in Bearbeitung befindliche Aufgabe enthält möglicherweise noch keine Bildergebnisse.

Bewährte Vorgehensweisen

1. Beschreiben Sie die Komposition präzise: ChatGPT Images 2.5 erzielt die besten Ergebnisse, wenn Prompts Motiv, Bildausschnitt, Beleuchtung und gewünschten Stil klar beschreiben.
2. Passen Sie das Seitenverhältnis an das Zielformat an: Legen Sie das Verhältnis für Social-Media-Beiträge, Banner, Produktseiten oder redaktionelle Layouts von Anfang an fest.
3. Verwenden Sie hochwertige Ausgangsbilder für Bearbeitungen: Scharfe, gut beleuchtete Eingabebilder verbessern die Wahrung der Motividentität und die Qualität lokaler Bearbeitungen.
4. Beschränken Sie Anfragen mit mehreren Bildern auf aussagekräftige Referenzen: Übergeben Sie bei Bearbeitungsanfragen nur relevante Bilder, um widersprüchliche visuelle Vorgaben zu vermeiden.