GPT-Image-2 Bildgenerierung

Documentation Index

Fetch the complete documentation index at: https://docs.apimart.ai/llms.txt

Use this file to discover all available pages before exploring further.

curl --request POST \
  --url https://api.apimart.ai/v1/images/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "gpt-image-2",
    "prompt": "A ginger cat sitting on a windowsill watching the sunset, watercolor style",
    "n": 1,
    "size": "16:9",
    "resolution": "2k"
  }'

{
  "code": 200,
  "data": [
    {
      "status": "submitted",
      "task_id": "task_01KPQ7J7DWB7QZ3WCEK3YVPBRA"
    }
  ]
}

​

Autorisierung

Authorization: Bearer YOUR_API_KEY

​

Body

​

Anwendungsbeispiele

{
  "model": "gpt-image-2",
  "prompt": "A ginger cat sitting on a windowsill watching the sunset, watercolor style"
}

{
  "model": "gpt-image-2",
  "prompt": "a corgi astronaut on the moon, cinematic, 8k",
  "size": "16:9",
  "resolution": "2k"
}

{
  "model": "gpt-image-2",
  "prompt": "An ancient castle under a starry sky",
  "size": "16:9",
  "resolution": "4k"
}

{
  "model": "gpt-image-2",
  "prompt": "Turn this photo into a watercolor painting",
  "image_urls": [
    "https://example.com/photo.jpg"
  ]
}

{
  "model": "gpt-image-2",
  "prompt": "Turn this photo into a watercolor painting",
  "image_urls": [
    "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAA..."
  ]
}

{
  "model": "gpt-image-2",
  "prompt": "Fuse these two photos into a single poster",
  "size": "4:3",
  "resolution": "2k",
  "image_urls": [
    "https://example.com/photo-a.jpg",
    "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAA..."
  ]
}

​

Response

​

Abfrage der Aufgabenergebnisse

​

Beispiel einer erfolgreichen Antwort

{
  "code": 200,
  "data": {
    "id": "task_01KPQ7J7DWB7QZ3WCEK3YVPBRA",
    "status": "completed",
    "progress": 100,
    "created": 1776748674,
    "completed": 1776748726,
    "actual_time": 52,
    "cost": 0.05279,
    "estimated_time": 100,
    "result": {
      "images": [
        {
          "url": [
            "https://upload.apimart.ai/f/image/xxxxxxxx-gpt_image_2_task_xxx_0.png"
          ],
          "expires_at": 1776835126
        }
      ]
    }
  }
}

​

Aufgabenstatus

​

Empfehlungen zum Polling

• Verzögerung der ersten Abfrage: Warten Sie nach dem Einreichen 10–20 Sekunden bis zur ersten Abfrage
• Abfrageintervall: Empfohlen werden 3–5 Sekunden, vermeiden Sie Millisekunden-Polling
• Timeout-Referenz: Ein einzelnes Bild ist typischerweise in 30–60 Sekunden fertig (beobachtete actual_time 44–53 s)
• Sammelabfrage: Verwenden Sie zum gleichzeitigen Abfragen mehrerer Aufgaben POST /v1/tasks/batch mit dem Body {"task_ids": ["task_xxx", "task_yyy"]}

​

Hinweise

1. Asynchrone Verarbeitung: Beim Einreichen wird task_id zurückgegeben, pollen Sie /v1/tasks/{task_id}, um die endgültige Bild-URL zu erhalten
2. Inhaltsmoderation: Der prompt wird zuerst geprüft — Verstöße werden ohne Abrechnung abgelehnt
3. Ergebnis-URL: Die Plattform spiegelt vorgelagerte temporäre signierte Links in ihren eigenen R2-Objektspeicher und gibt einen stabilen Link zurück, auf den Clients direkt zugreifen können
4. URL-Gültigkeit: expires_at = completed + 24h in der Antwort ist ein Hinweisfeld; bitte zeitnah herunterladen oder auf Ihr eigenes CDN spiegeln
5. Seitenverhältnis-Konflikt: Verwenden Sie das Feld size für das Seitenverhältnis — vermeiden Sie es, dies im prompt zu wiederholen, um vorgelagerte Mehrdeutigkeiten zu vermeiden
6. Abrechnung: Abrechnung nach Auflösungsstufe (1K / 2K / 4K), keine Abrechnung bei Fehler oder Ablehnung durch Moderation
7. Für 4K unterstützte Seitenverhältnisse: Alle 15 Verhältnisse oben unterstützen 4K; Sie können die entsprechenden Pixelabmessungen auch direkt über size übergeben
8. Aufgaben-Aufbewahrung: task_id wird standardmäßig mehrere Tage in der Datenbank aufbewahrt (konfiguriert über TASK_RETENTION_DAYS) — abgelaufene Abfragen geben „Aufgabe existiert nicht oder ist abgelaufen” zurück