---
title: "Query image character swap task"
method: GET
path: "/v1/character_swap/task/query"
tags: ["Image Character Swap"]
---

# Query image character swap task

`GET /v1/character_swap/task/query`

## Query parameters

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

## Response `200`

Query success

- object
  - `code` string, required — 200:success Other:fail
  - `message` string, required
  - `result` object
    - `taskId` string
    - `status` 'init' | 'running' | 'fail' | 'success' — init | running | fail | success
    - `outputFileId` string
    - `outputImageUrl` string
    - `costCredit` number, double
    - `errorCode` string
    - `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/revisions/83cd46ca7859/schema)