Audio Generating
Generate an audio clip (supports sound effects & BGM) by inputting a text prompt.
POST https://api.vidu.com/ent/v2/text2audioField | Value | Description |
|---|---|---|
Content-Type | application/json | Data format |
Authorization | Token {your api key} | Replace {your_api_key} with your actual API Key |
Field | Type | Required | Description |
|---|---|---|---|
model | String | Required | Model Available value: audio1.0 |
prompt | String | Required | Text prompt describing the audio. Maximum length: 1500 characters. |
duration | Float | Optional | Audio duration. Default: 10 seconds. Range: 2–10 seconds. |
seed | Int | Optional | Random seed. If not provided or set to 0, a random value will be used. Fixed value ensures reproducibility. |
callback_url | String | Optional | Callback When creating a task, you need to actively set the callback_url with a POST request. When the video generation task changes its status, Vidu will send a callback request to this URL, containing the latest status of the task. The structure of the callback request content will be the same as the return body of the GET Generation API.The “status” in the callback response includes the following states:- processing: Task is being processed.- success: Task is completed (if sending fails, it will retry the callback three times).- failed: Task failed (if sending fails, it will retry the callback three times).Vidu uses a callback signature algorithm for verification, check out the details here: Callback Signature |
Field | Type | Description |
|---|---|---|
task_id | String | Vidu generated Task ID |
state | String | Task state:： - created created task successfully - queueing task in queue - processing processing - success generation successful - failed task failed |
model | String | Model parameter used |
prompt | String | Prompt text used |
duration | Int | Audio duration |
seed | Int | Random seed used |
credits | Int | The credits used for this call |
created_at | String | Task creation timestamp (ISO8601 format) |
{ "task_id": "your_task_id_here", "state": "created", "model": "audio1.0", "prompt": "Birds chirping in the morning", "duration": 10, "seed": random_number, "credits": credits_number, "created_at": "2025-01-01T15:41:31.968916Z" }