---
title: "Submit Task"
method: POST
path: "/v1/instant_voice_clone/task/submit"
---

# Submit Task

`POST /v1/instant_voice_clone/task/submit`

Submit an async Instant Voice Clone task and receive `taskId`. Poll the query endpoint for final result.

V1 constraints:
- `model` supports `Index TTS` and `Fish Audio S2 Pro`
- `referenceAudioFileId` must point to a wav audio file
- output audio format is mp3

Note: `Fish Audio S2 Pro` does not support emotion params (`emotionMode` / `emotionVector` / `emotionText`).

## Headers

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

## Request body

- object
  - `model` 'Index TTS' | 'Fish Audio S2 Pro', required — Display model name (required). Allowed values: `Index TTS`, `Fish Audio S2 Pro`
  - `text` string, required — Voice script text (required)
  - `referenceAudioFileId` string, required — Reference audio fileId (required), must be wav
  - `emotionMode` 'slider' | 'prompt' — Emotion mode (optional): `slider` or `prompt`. Supported by `Index TTS` only
  - `emotionVector` string — Slider emotion vector (optional). Required when `emotionMode=slider`
  - `emotionText` string — Prompt emotion text (optional). Required when `emotionMode=prompt`
  - `boardId` string — Board ID (optional)
  - `noticeUrl` string — Task completion callback URL (optional)

## Response `200`

Accepted

- object
  - `code` string
  - `message` string
  - `result` object
    - `taskId` string — Task ID
    - `status` 'init' | 'running' | 'success' | 'fail' — Submit acceptance status
    - `boardTaskIds` string[] — Returned when board integration is enabled
    - `boardId` string — Returned when board integration is enabled
    - `noticeUuid` string — Returned when `noticeUrl` is provided

---

[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)