> ## 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.

# Query responses (OpenAI Responses API)

> OpenAI Responses API asynchronous task query API. `response_id` Use the complete `id` returned in the creation response; do not truncate or rewrite it.

Query asynchronous image tasks for OpenAI Responses API. `response_id` You must use the complete `id` returned by `POST /v1/responses`, for example `resp_xxx`.

## Asynchronous Query Examples

```http
GET /v1/responses/resp_xxx
```

Path parameter equivalence note:

```json
{
  "response_id": "resp_xxx"
}
```

Completed-state response example:

```json
{
  "id": "resp_xxx",
  "created_at": 1780649146,
  "error": null,
  "incomplete_details": null,
  "instructions": null,
  "metadata": {},
  "model": "gpt-image-2-2k",
  "object": "response",
  "output": [
    {
      "id": "ig_010c31178d26436ca6194cde07931b33_0",
      "result": null,
      "status": "completed",
      "type": "image_generation_call",
      "url": "https://example.png"
    }
  ],
  "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": "completed",
  "text": null,
  "truncation": null,
  "usage": null,
  "user": null,
  "store": null
}
```



## OpenAPI

````yaml api-reference/en/openapi.json GET /v1/responses/{response_id}
openapi: 3.0.0
info:
  title: Overseas Expansion Camp API Reference Documentation
  version: 1.0.0
  description: Public AI Gateway API Reference
servers:
  - url: https://api.aiid.edu.kg
security:
  - BearerAuth: []
tags:
  - name: OpenAI format (Chat)
  - name: OpenAI Format (Responses)
  - name: Gemini Format for Image Generation
  - name: Image generationOpenAI DALL-E format
  - name: List models
  - name: Video generationHappyHorse and Wan
  - name: Video generation Kling format
  - name: Video generation Omni and Veo formats
  - name: Video generation Seedance
  - name: Video generation Sora compatible formats
  - name: Video generation Vidu
  - name: Music generation task format
paths:
  /v1/responses/{response_id}:
    get:
      tags:
        - OpenAI Format (Responses)
      summary: Query responses (OpenAI Responses API)
      description: >-
        OpenAI Responses API asynchronous task query API. `response_id` Use the
        complete `id` returned in the creation response; do not truncate or
        rewrite it.


        Query asynchronous image tasks for OpenAI Responses API. `response_id`
        You must use the complete `id` returned by `POST /v1/responses`, for
        example `resp_xxx`.


        ## Asynchronous Query Examples


        ```http

        GET /v1/responses/resp_xxx

        ```


        Path parameter equivalence note:


        ```json

        {
          "response_id": "resp_xxx"
        }

        ```


        Completed-state response example:


        ```json

        {
          "id": "resp_xxx",
          "created_at": 1780649146,
          "error": null,
          "incomplete_details": null,
          "instructions": null,
          "metadata": {},
          "model": "gpt-image-2-2k",
          "object": "response",
          "output": [
            {
              "id": "ig_010c31178d26436ca6194cde07931b33_0",
              "result": null,
              "status": "completed",
              "type": "image_generation_call",
              "url": "https://example.png"
            }
          ],
          "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": "completed",
          "text": null,
          "truncation": null,
          "usage": null,
          "user": null,
          "store": null
        }

        ```
      parameters:
        - name: response_id
          in: path
          required: true
          schema:
            type: string
            example: resp_xxx
          description: The full ID returned in the creation response.
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: object
                properties:
                  id:
                    type: string
                    example: resp_xxx
                    description: Response ID。
                  object:
                    type: string
                    example: response
                  created_at:
                    type: integer
                  status:
                    type: string
                    example: in_progress
                    description: >-
                      Task status, commonly `queued`, `in_progress`,
                      `completed`, and `failed`.
                  model:
                    type: string
                  output:
                    type: array
                    items:
                      type: object
                      properties:
                        url:
                          type: string
                          description: The image URL after the image task is completed.
                  metadata:
                    type: object
                    properties:
                      task_id:
                        type: string
                        description: Upstream task ID metadata.
                  error:
                    type: object
                    nullable: true
                    description: The error object returned on failure.
              examples:
                responses_image_async_completed:
                  summary: Image generation async query completion response
                  value:
                    id: resp_xxx
                    created_at: 1780649146
                    error: null
                    incomplete_details: null
                    instructions: null
                    metadata: {}
                    model: gpt-image-2-2k
                    object: response
                    output:
                      - id: ig_010c31178d26436ca6194cde07931b33_0
                        result: null
                        status: completed
                        type: image_generation_call
                        url: https://example.png
                    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: completed
                    text: null
                    truncation: null
                    usage: null
                    user: null
                    store: null
components:
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      description: |-
        Use Bearer Token authentication.
        Format: `Authorization: Bearer sk-xxxxxx`

````