1. Overview
1.1 Service Capabilities
ToMoviee 2.0 introduces innovations in Text to Sound, enabling instant adjustment of sound style, genre, emotion, and tone with a single prompt. When a video requires specific sound effects to enhance the atmosphere or depict actions, simply describe the scene or action in text. The system then intelligently generates rich, highly detailed, and realistic ambient and action sound effects that perfectly fit the context. This feature significantly streamlines sound effect production, efficiently providing all necessary ambient sound effects to accurately translate text prompts into authentic sound textures. This notably enhances video realism and spatial presence. Eliminating the need for complex sound effect library searches or professional recordings, ToMoviee 2.0 delivers high-quality, context-aware sound effect assets that perfectly match the visuals. This accelerates the overall production workflow.
1.2 Sample Prompts and Outputs
|
prompt |
Output Sound Effect |
Output Thumbnail and Title |
|
rain |
Title: Rain Whispers Softly |
|
|
heavy raining in the city with grumbling thunder and lightning |
Title: Roar of the Thunderstorm |
|
|
Generate a big long cartoony wet kiss |
|
Title: Cartoony Wet Kiss Sound |
2Prompt engine
|
Prompt = Subject + Scene (Mood or Style)
|
3. API Requests
3.1 Request URL
https://open-api.wondershare.cc/v1/open/capacity/application/tm_text2sfx3.2 Request Parameters (versioning required)
Method： POST
Headers
|
Parameter Name |
Value |
Required |
Example |
Description |
|
Content-Type |
application/json |
是 |
|
|
|
Authorization |
|
是 |
Basic xxx |
Security verification information, in the format of Basic {access_token}, where access_token is a token, generated using the given app_key and app_crit, with the generation method being base64 (app_key: app_crit) |
|
X-App-Key |
|
Assigned appkey |
Body
|
Parameter Name |
Type |
Required |
Default Value |
Description |
Other Info |
|
prompt |
string |
Yes |
|
Text prompt, which must contain fewer than 77 tokens. The excess will be truncated. |
|
|
duration |
number |
Yes |
|
Desired length of the generated audio. Unit: seconds. The value must be greater than 0 and less than 47. |
|
|
qty |
integer |
Yes |
|
Number of tracks to generate. Valid values: 1–4. |
|
|
callback |
string |
No |
|
Callback URL. |
|
|
params |
string |
No |
|
回调透明参数 |
|
3.3 Response
|
Parameter Name |
Type |
Required |
Default Value |
Description |
Other Info |
|
code |
number |
Yes |
|
Error code. |
|
|
msg |
string |
Yes |
|
Error message. |
|
|
data |
object |
No |
|
|
|
|
├─ task_id |
string |
No |
|
Task ID. |
|