---
title: "New Endpoint"
method: GET
path: "/v1/image_generate/task/query"
---

# New Endpoint

`GET /v1/image_generate/task/query`

This is your first endpoint! Edit this page to start documenting your API.

## Query parameters

- `taskId` string, required
- `needCloudFrontUrl` string

## Headers

- `Topview-Uid` string, required
- `Authorization` string, required

## Response `200`

- object
  - `code` string, required — 200:success Other:fail
  - `message` string, required
  - `result` object — When code is 200, the result content will be returned.
    - `taskId` string
    - `status` string — success/fail
    - `mode` string — BATCH/SINGLE
    - `costCredit` string — The credit consumed by this task
    - `details` object[] — Generated Image Infomation
      - `fileId` string — Image fileId
      - `fileName` string
      - `format` string
      - `language` string — Language for generated image
      - `finishedImageUrl` string — Generated Image Url
      - `status` string — success/fail
      - `errorMsg` string

---

[API](https://skmtc.net/topview/apis/image-character-swap-apis-editable-in-readme.md) · [All operations](https://skmtc.net/topview/apis/image-character-swap-apis-editable-in-readme/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/topview/image-character-swap-apis-editable-in-readme/versions/83cd46ca7859/schema)