Do TTS Pro

POSThttps://api.newportai.com/api/async/do_tts_pro

The Do TTS Pro API provides access to our professional-grade voice library, offering enhanced vocal dynamics and superior clarity. By selecting a voiceId from the "Pro" category, you can generate high-fidelity speech from any provided text.

Select a voiceId from the Pro Voice List to use as the audioId.
Submit a POST request to the Do TTS Pro API to obtain a taskId.
Submit a POST request to the Polling API to retrieve the final audioUrl.
Configure a Callback URL to receive results automatically on completion.

Request Headers

Content-Type string Required

Enum: application/json

Authorization string Required

Bearer authentication token. Example: Bearer {{APIKey}}.

Request Body

audioId string Required

The unique identifier of the chosen Pro voice. Visit the Voice List, navigate to the "Pro" version section, and copy the desired voiceId.

text string Required

The text string to be converted into high-fidelity speech.

lan string Required

The target language code for the voice output (e.g., en, zh-CN, es).

Response

code integer

Returns 0 for success, or a specific error code.

message string

Returns "success" or a descriptive error message.

data object

taskId string

The unique identifier for the task. Use this ID with the Polling API to retrieve the generated output.

Errors

10192Illegal param

Polling

Use the Polling API to retrieve the processing results.

Callback

Alternatively, you can enable Callback to receive task results automatically upon completion.

0Task Completed

12345678910111213141516171819{
    "code": 0,
    "message": "success",
    "data": {
        "task": {
            "taskId": "496d20fd83f49bbe985d32da4d099e51",
            "status": 3,
            "executionTime": 17232,
            "expire": 1769586737611,
            "taskType": "tts_pro"
        },
        "audios": [
            {
                "audioUrl": "https://dreamface-resource-aigc.oss-us-east-1.aliyuncs.com/apiDocsAdmin/2025-4-1744804212969-dottsClone_result.wav",
                "audioType": ".wav"
            }
        ]
    }
}

Request

cURL

12345678curl -X POST 'https://api.newportai.com/api/async/do_tts_pro' \
  -H "Authorization: Bearer {{key}}" \
  -H 'Content-Type: application/json' \
  -d '{
    "audioId": "b90847cb8cfe4446881c6a3e15118084",
    "text": "let us see this world",
    "lan": "en"
}'

0Successful

1234567{
    "code": 0,
    "message": "success",
    "data": {
        "taskId": "496d20fd83f49bbe985d32da4d099e51"
    }
}