---
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`

## Request

- Base URL: `https://api.topview.ai`
- URL: `https://api.topview.ai/v1/character_swap/task/query`
- Auth: API key in header `Topview-Uid` and API key in header `Authorization`

## 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.dev/topview/apis/image-character-swap-apis-editable-in-readme.md) - [All operations](https://skmtc.dev/topview/apis/image-character-swap-apis-editable-in-readme/llms.txt) - [OpenAPI document](https://skmtc.dev/topview/apis/image-character-swap-apis-editable-in-readme/revisions/286c6daf6859?raw)
