---
title: "New Endpoint"
method: POST
path: "/v1/voice/text2voice/task/submit"
---

# New Endpoint

`POST /v1/voice/text2voice/task/submit`

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

## Headers

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

## Request body

- object
  - `voiceId` string, required — voiceId. Get it from interface **[Voice Query](https://docs.topview.ai/reference/voice_query#/)**
  - `voiceText` string — voiceText can use the<break time=\ "1.0s \"/>tag to specify how long to pause at the break location (0.1-99.9, up to one decimal place). </br> Example: welcome to <break time=\ "1.0s \"/> topview.When reading "to", there will be a pause of 1 seconds, and then continue reading "topview".
  - `voiceSpeed` number, required — voiceSpeed. If it is empty, default 1. The effective range is [0.8 ~ 1.2]
  - `emotionName` 'happy' | 'neutral' | 'surprised' | 'angry' | 'sad' | 'fearful' | 'disgusted'
  - `pronRules` object[] — Pronunciation control rules (replacing old strings with new strings)
    - `oldStr` string — The string to be replaced by newStr
    - `newStr` string
  - `noticeUrl` string — NoticeUrl. Please refer to the **[API documentation for details NoticeUrl](https://docs.topview.ai/reference/post_notice-notice-url-check#/)**
  - `boardId` string — Board ID (optional). If provided, the task will be associated with this board.

## Response `200`

- object
  - `code` string, required — Response code
  - `message` string — Response message
  - `result` object
    - `taskId` string — Unique task identifier
    - `status` string — Task status
    - `errorMsg` string — Error message if task submission failed
    - `subTaskId` string — Sub-task identifier (optional)
    - `boardTaskIds` string[] — List of board task IDs (if task is associated with a board)
    - `boardId` string — Associated board ID (if provided in request)
    - `noticeUuid` string — UUID for callback notification tracking
    - `data` object — Additional data (if any)

---

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