> ## Documentation Index > Fetch the complete documentation index at: https://docs.aiid.edu.kg/llms.txt > Use this file to discover all available pages before exploring further. # 创建响应 (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` 获取图片链接。 ### 创建异步图片任务示例 ```http POST /v1/responses Content-Type: application/json ``` ```json { "model": "gpt-image-2-2k", "input": "生成一张 2K 横屏产品海报，白色运动鞋，干净棚拍光线，高级商业摄影风格。", "stream": false, "tools": [ { "type": "image_generation" } ], "background": true } ``` 创建接口返回示例： ```json { "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`。 ## OpenAPI ````yaml api-reference/cn/openapi.json POST /v1/responses openapi: 3.0.0 info: title: 出海营 API 参考文档 version: 1.0.0 description: Public AI Gateway API Reference servers: - url: https://api.aiid.edu.kg security: - BearerAuth: [] tags: - name: OpenAI格式(Chat) - name: OpenAI格式(Responses) - name: 图片生成Gemini格式 - name: 图片生成OpenAI DALL-E格式 - name: 获取模型列表 - name: 视频生成HappyHorse与Wan - name: 视频生成Kling格式 - name: 视频生成Omni与Veo格式 - name: 视频生成Seedance格式 - name: 视频生成Sora兼容格式 - name: 视频生成Vidu格式 - name: 音乐生成任务格式 paths: /v1/responses: post: tags: - OpenAI格式(Responses) summary: 创建响应 (OpenAI Responses API) description: >- 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` 获取图片链接。 ### 创建异步图片任务示例 ```http POST /v1/responses Content-Type: application/json ``` ```json { "model": "gpt-image-2-2k", "input": "生成一张 2K 横屏产品海报，白色运动鞋，干净棚拍光线，高级商业摄影风格。", "stream": false, "tools": [ { "type": "image_generation" } ], "background": true } ``` 创建接口返回示例： ```json { "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`。 operationId: createResponse parameters: [] requestBody: content: application/json: schema: $ref: '#/components/schemas/ResponsesRequest' properties: {} examples: responses_image_async: summary: 图片生成异步 value: model: gpt-image-2-2k input: 生成一张 2K 横屏产品海报，白色运动鞋，干净棚拍光线，高级商业摄影风格。 stream: false tools: - type: image_generation background: true required: true responses: '200': description: 成功创建响应 content: application/json: schema: $ref: '#/components/schemas/ResponsesResponse' examples: responses_image_async_queued: summary: 图片生成异步创建返回 value: 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 headers: {} deprecated: false security: - BearerAuth: [] components: schemas: ResponsesRequest: type: object required: - model properties: model: type: string input: description: 输入内容，可以是字符串或消息数组 oneOf: - type: string - type: array items: type: object properties: {} instructions: type: string max_output_tokens: type: integer temperature: type: number top_p: type: number stream: type: boolean tools: type: array items: type: object properties: {} tool_choice: oneOf: - type: string - type: object properties: {} reasoning: type: object properties: effort: type: string enum: - low - medium - high summary: type: string previous_response_id: type: string truncation: type: string enum: - auto - disabled ResponsesResponse: type: object properties: id: type: string object: type: string example: response created_at: type: integer status: type: string enum: - completed - failed - in_progress - incomplete model: type: string output: type: array items: type: object properties: type: type: string id: type: string status: type: string role: type: string content: type: array items: type: object properties: type: type: string text: type: string usage: $ref: '#/components/schemas/Usage' Usage: type: object properties: prompt_tokens: type: integer description: 提示词 Token 数 completion_tokens: type: integer description: 补全 Token 数 total_tokens: type: integer description: 总 Token 数 prompt_tokens_details: type: object properties: cached_tokens: type: integer text_tokens: type: integer audio_tokens: type: integer image_tokens: type: integer completion_tokens_details: type: object properties: text_tokens: type: integer audio_tokens: type: integer reasoning_tokens: type: integer securitySchemes: BearerAuth: type: http scheme: bearer description: |- 使用 Bearer Token 认证。 格式: `Authorization: Bearer sk-xxxxxx` ````