Créer une réponse (OpenAI Responses API)

OpenAI Responses API, utilisé pour créer des réponses de modèle. Prend en charge le dialogue multi-tours, l’appel d’outils, le raisonnement et d’autres fonctionnalités.

Ajoute des cas d’usage asynchrones de génération d’images pour OpenAI Responses API. background=true sert à soumettre des tâches en arrière-plan ; l’interface de création renvoie immédiatement status=queued et id complets, puis utilise ce id pour appeler GET /v1/responses/{response_id} et interroger le résultat.

Flux de génération asynchrone d’images

1. Appelez POST /v1/responses et transmettez tools=[{ "type": "image_generation" }] dans le corps de la requête, avec background=true.
2. Enregistrez le id complet renvoyé par l’interface de création, par exemple resp_xxx. Ne le tronquez pas, ne le réécrivez pas et ne conservez pas uniquement metadata.task_id.
3. Appelez GET /v1/responses/{response_id} pour interroger, jusqu’à status=completed ou status=failed.
4. Une fois l’opération réussie, lisez output[].url pour obtenir le lien de l’image.

Exemple de création d’une tâche d’image asynchrone

POST /v1/responses
Content-Type: application/json

{
  "model": "gpt-image-2-2k",
  "input": "生成一张 2K 横屏产品海报，白色运动鞋，干净棚拍光线，高级商业摄影风格。",
  "stream": false,
  "tools": [
    {
      "type": "image_generation"
    }
  ],
  "background": true
}

Modifier avec une image de référence et spécifier le format d’image

input peut transmettre un tableau de messages ; dans le content d’un même message utilisateur, mélangez input_text et input_image. tools[].ratio spécifie le format d’image généré.

{
  "model": "gpt-image-2-2k",
  "input": [
    {
      "role": "user",
      "content": [
        {
          "type": "input_text",
          "text": "生成新图片 4K, 16:9"
        },
        {
          "type": "input_image",
          "image_url": "https://imageproxy.zhongzhuan.chat/api/proxy/image/70a98de9c9d48160812454b4ee21edbf.jpg",
          "detail": "auto"
        }
      ]
    }
  ],
  "stream": false,
  "tools": [
    {
      "type": "image_generation",
      "ratio": "16:9"
    }
  ],
  "background": true
}

Dans cet exemple, model est gpt-image-2-2k ; si vous avez besoin du niveau 4K, utilisez plutôt gpt-image-2-4k, au lieu d’écrire simplement « 4K » dans le prompt.

Exemple de réponse de l’interface de création :

{
  "id": "resp_xxx",
  "created_at": 1780649146,
  "error": null,
  "incomplete_details": null,
  "instructions": null,
  "metadata": {
    "task_id": "010c31178d26436ca6194cde07931b33"
  },
  "model": "gpt-image-2-2k",
  "object": "response",
  "output": [],
  "parallel_tool_calls": true,
  "temperature": null,
  "tool_choice": null,
  "tools": null,
  "top_p": null,
  "max_output_tokens": null,
  "previous_response_id": null,
  "reasoning": null,
  "status": "queued",
  "text": null,
  "truncation": null,
  "usage": null,
  "user": null,
  "store": null
}

Modèles pris en charge : gpt-image-2-2k, gpt-image-2-4k, nano-banana-pro.