---
title: "GET /openai/gpt/fetch"
method: GET
path: "/openai/gpt/fetch"
---

# GET /openai/gpt/fetch

`GET /openai/gpt/fetch`

Query image generation result

## Query parameters

- `jobId` string, required

## Response `200`

Request successful

- object
  - `status` 'SUCCESS' | 'ON_QUEUE' | 'FAILED', required — Task status: ON_QUEUE-processing, SUCCESS-success, FAILED-failed
  - `message` string, nullable, required — Response message: returns success on success, returns specific error reason on failure, returns null during processing
  - `jobId` string, required — Unique task identifier for querying task status or receiving callback notifications
  - `data` union, required — Task data (different fields returned based on status)
    - object
      - `prompt` string, required — Text prompt for image generation
      - `referImages` string[], required — Reference image URL list
      - `imageUrl` string, required — Generated result image URL (returned on success). See [Storage & Persistence](/grids/en/faq/storage) for validity period.
      - `model` string
      - `quota` string, required — Quota consumed
      - `finishTime` string, required — Task completion time (format: YYYY-MM-DD HH:mm:ss)
      - `hookUrl` string, required — Callback URL
    - object
      - `prompt` string, required — Text prompt for image generation
      - `referImages` string[], required — Reference image URL list
      - `imageUrl` string — Generated result image URL (returns null during processing)
      - `model` string
      - `quota` string, required — Quota consumed
      - `finishTime` string — Task completion time (returns null during processing)
      - `hookUrl` string, required — Callback URL
    - object
      - `prompt` string, required — Text prompt for image generation
      - `referImages` string[], required — Reference image URL list
      - `imageUrl` string — Generated result image URL (returns null on failure)
      - `model` string
      - `quota` string, required — Quota consumed (returns 0 on failure)
      - `finishTime` string, required — Task completion time (format: YYYY-MM-DD HH:mm:ss)
      - `hookUrl` string, required — Callback URL

## Other responses

- `400` — Parameter error
- `401` — Authorization failed

---

[API](https://skmtc.net/ttapi/apis/flowmusic-api-docs.md) · [All operations](https://skmtc.net/ttapi/apis/flowmusic-api-docs/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ttapi/flowmusic-api-docs/versions/f27f8a59dbd0/schema)