Génération d'images GPT-Image-2

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"
    }
  ]
}

​

Autorisations

Authorization: Bearer YOUR_API_KEY

​

Body

​

Exemples d’utilisation

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

​

Interrogation des résultats de tâche

​

Exemple de réponse en cas de succès

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

​

Statuts de tâche

​

Recommandations pour l’interrogation

• Délai avant la première requête : Attendez 10 à 20 secondes après soumission avant la première requête
• Intervalle d’interrogation : 3 à 5 secondes recommandées, évitez l’interrogation à la milliseconde
• Référence de délai d’expiration : Une image unique se termine généralement en 30 à 60 secondes (actual_time observé de 44 à 53 s)
• Requête par lot : Pour interroger plusieurs tâches à la fois, utilisez POST /v1/tasks/batch avec le corps {"task_ids": ["task_xxx", "task_yyy"]}

​

Notes

1. Traitement asynchrone : La soumission renvoie task_id, interrogez /v1/tasks/{task_id} pour obtenir l’URL finale de l’image
2. Modération de contenu : Le prompt est d’abord examiné — les violations sont rejetées sans facturation
3. URL du résultat : La plateforme reflète les liens signés temporaires en amont dans son propre stockage objet R2, renvoyant un lien stable auquel les clients peuvent accéder directement
4. Validité de l’URL : expires_at = completed + 24h dans la réponse est un champ indicatif, veuillez télécharger ou refléter rapidement vers votre propre CDN
5. Conflit de ratio : Utilisez le champ size pour le ratio d’aspect — évitez de le répéter dans le prompt pour prévenir toute ambiguïté en amont
6. Facturation : Facturé par niveau de résolution (1K / 2K / 4K), aucun frais en cas d’échec ou de rejet par la modération
7. Ratios pris en charge en 4K : Les 15 ratios ci-dessus prennent tous en charge la 4K ; vous pouvez également transmettre les dimensions en pixels correspondantes directement via size
8. Rétention des tâches : Le task_id est conservé dans la base de données par défaut pendant plusieurs jours (configuré par TASK_RETENTION_DAYS) — les requêtes expirées renvoient « la tâche n’existe pas ou a expiré »