F5 TTS
Turn text into speech using the voice from a reference audio recording. Only F5-TTS is currently available.
Pricing
The charge per call is (max(60 × text input characters, 0)) AE credits. All applicable conditions are combined to calculate the total.
All available model options are charged based on input text characters. Automatic speech recognition is used when reference text is left empty, and silence removal is enabled by default. No separate charges for these options are listed in the available pricing information. This pricing description applies to normal successful calls and is not an absolute minimum for cases such as empty results.
Parameters
Optional parameters use the platform defaults when omitted.
| Parameter | Type | Required | Description | Default |
|---|---|---|---|---|
request_body | object | Yes | No parameter description. | — |
request_body.gen_text | string | Yes | The text to be converted to speech. Maximum 5000 characters. | — |
request_body.ref_text | string | No | The reference text to be used for TTS. If not provided, an ASR (Automatic Speech Recognition) model will be used to generate the reference text. | "" |
request_body.model_type | enum (F5-TTS) | Yes | The name of the model to be used for TTS. Currently available values: F5-TTS. | — |
request_body.ref_audio_url | string | Yes | The URL of the reference audio file. | — |
request_body.remove_silence | boolean | No | Whether to remove the silence from the audio file. | true |
Invocation example
Copy the request and explore its response example.
/agent-api/v1/tool/executeX-Api-KeySubmit first, then query with the returned task_id until the task completes.
curl --request POST \
--url 'https://agentearth.ai/agent-api/v1/tool/execute?tool_name=ae_f5_tts' \
--header "X-Api-Key: $AGENTEARTH_API_KEY" \
--header 'Content-Type: application/json' \
--data-raw '{
"params": {
"request_body": {
"gen_text": "工具再火,\n得你能用上,\n那才叫真火!",
"model_type": "F5-TTS",
"ref_audio_url": "https://agentearth.ai/fileserver/file/18e4279f-b482-46f2-81f1-aad43f631ef5.mp3",
"remove_silence": false
}
}
}'{
"description": "task accepted; poll the result via query_tool with this task_id",
"query_tool": "ae_get_result",
"status": "created",
"task_id": "b7339ca5-7326-4d60-a8d4-28c82a075396"
}Guides using this tool
See how this tool fits into real workflows





