Submit Task

post

https://api.topview.ai/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).

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Body Params

model

string

enum

required

Display model name (required). Allowed values: Index TTS, Fish Audio S2 Pro

Allowed:

text

string

required

Voice script text (required)

referenceAudioFileId

string

required

Reference audio fileId (required), must be wav

emotionMode

string

enum

Emotion mode (optional): slider or prompt. Supported by Index TTS only

Allowed:

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)

Headers

Topview-Uid

string

required

Defaults to uid

User ID

Authorization

string

required

Defaults to Bearer apiKey

API key, format: Bearer {apiKey}

Response

Language

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

200Accepted