Создать ответ (OpenAI Responses API)

OpenAI Responses API — используется для создания ответов модели. Поддерживает многопотоковые диалоги, вызов инструментов, логический вывод и другие функции.

Дополните асинхронный сценарий генерации изображений в OpenAI Responses API. background=true используется для отправки фоновой задачи; интерфейс создания сразу возвращает status=queued и полный id, после чего с помощью этого id вызывается GET /v1/responses/{response_id} для запроса результата.

Процесс асинхронной генерации изображений

1. Вызовите POST /v1/responses, передав в теле запроса tools=[{ "type": "image_generation" }] и background=true.
2. Сохраните полный id, возвращаемый интерфейсом создания, например resp_xxx. Не обрезайте, не переписывайте и не сохраняйте только metadata.task_id.
3. Вызовите GET /v1/responses/{response_id} для проверки, пока не будет status=completed или status=failed.
4. После успешного выполнения прочитайте output[].url, чтобы получить ссылку на изображение.

Пример создания асинхронной задачи на генерацию изображения

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

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

Редактирование с использованием референсного изображения и указанием соотношения сторон

input может передавать массив сообщений; в content одного пользовательского сообщения можно смешивать input_text и input_image. tools[].ratio задает соотношение сторон генерируемого изображения.

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

В этом примере model — gpt-image-2-2k; если нужен уровень 4K, используйте gpt-image-2-4k, а не просто указывайте «4K» в промпте.

Пример ответа интерфейса создания:

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

Поддерживаемые модели: gpt-image-2-2k, gpt-image-2-4k, nano-banana-pro.