---
title: "GET /insightFace/v1/fetch"
method: GET
path: "/insightFace/v1/fetch"
---

# GET /insightFace/v1/fetch

`GET /insightFace/v1/fetch`

Query face swap task results. The returned data structure is consistent with the <a href="fetch" target="_self">hookUrl</a> return format.<br/>Note: jobId can be passed via URL parameters (Query) or request body (Body)

## 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, required — Response message: empty string on success, returns specific error reason on failure (e.g., 'insufficient quota', 'prompt violation')
  - `jobId` string, required — Unique task identifier for querying task status or receiving callback notifications
  - `data` union
    - object — Data returned when task succeeds
      - `targetImage` string — URL of the template image uploaded by the user. Validity: see [Storage and Persistence](/grids/en/faq/storage)
      - `swapImage` string — URL of the face image uploaded by the user. Validity: see [Storage and Persistence](/grids/en/faq/storage)
      - `discordImage` string — Discord address of the result returned when the task is successful, not directly accessible in China. Validity: see [Storage and Persistence](/grids/en/faq/storage)
      - `cdnImage` string — TTAPI proxy address of the result returned when the task is successful, directly accessible in China. Validity: see [Storage and Persistence](/grids/en/faq/storage)
      - `quota` string — Quota consumed
      - `hookUrl` string — Callback URL
      - `finishTime` string — Completion time
    - object — Data returned when task is processing
    - object — Data returned when task fails

## Other responses

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

---

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