10-Text-to-Audio
Text to Audio
Doc version: v1.0.0 | Last updated: 2026-06-11 This platform fully supports the Kling AI official video generation API. Requests and responses are transparently proxied; parameter semantics are identical to the official API.
Create Task
POST https://platform.dataeyes.ai/kling/v1/audio/text-to-audioRequest Headers
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
Content-Type | string | Yes | application/json | Data Exchange Format |
Authorization | string | Yes | Authentication information, refer to API authentication |
Request Body
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
prompt | string | Yes | Text prompt - Cannot exceed 200 characters | |
duration | float | Yes | Generated audio duration - Value range: 3.0s - 10.0s, supports one decimal place precision | |
external_task_id | string | No | Customized Task ID - Users can provide a customized task ID, which will not overwrite the system-generated task ID but can be used for task queries. - Please note that the customized task ID must be unique within a single user account. | |
callback_url | string | No | The callback notification address for the result of this task. If configured, the server will actively notify when the task status changes - The specific message schema of the notification can be found in Callback Protocol |
Request Example
curl --request POST \
--url https://platform.dataeyes.ai/kling/v1/audio/text-to-audio \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"prompt": "Fireworks sound during Chinese New Year celebration",
"duration": 3,
"external_task_id": "",
"callback_url": ""
}'Response Example
{
"code": 0, // Error codes; Specific definitions can be found in "Error Code"
"message": "string", // Error information
"request_id": "string", // Request ID, generated by the system, used to track requests and troubleshoot problems
"data": {
"task_id": "string", // Task ID, generated by the system
"task_info": { // Task creation parameters
"external_task_id": "string" // Customer-defined task ID
},
"task_status": "string", // Task status, Enum values: submitted, processing, succeed, failed
"created_at": 1722769557708, // Task creation time, Unix timestamp, unit: ms
"updated_at": 1722769557708 // Task update time, Unix timestamp, unit: ms
}
}Query Task (Single)
GET https://platform.dataeyes.ai/kling/v1/audio/text-to-audio/{id}Request Headers
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
Content-Type | string | Yes | application/json | Data Exchange Format |
Authorization | string | Yes | Authentication information, refer to API authentication |
Request Example
curl --request GET \
--url https://platform.dataeyes.ai/kling/v1/audio/text-to-audio/{task_id} \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json'Response Example
{
"code": 0, // Error codes; Specific definitions can be found in "Error Code"
"message": "string", // Error information
"request_id": "string", // Request ID, generated by the system, used to track requests and troubleshoot problems
"data": {
"task_id": "string", // Task ID, generated by the system
"task_status": "string", // Task status, Enum values: submitted, processing, succeed, failed
"task_status_msg": "string", // Task status message, displaying the failure reason when the task fails (such as triggering the platform's content risk control, etc.)
"task_info": { // Task creation parameters
"external_task_id": "string" // Customer-defined task ID
},
"task_result": {
"audios": [
{
"id": "string", // Audio ID; globally unique
"url_mp3": "string", // URL for generated audio in MP3 format (Please note that for information security, generated audios will be cleared after 30 days. Please save them promptly.)
"url_wav": "string", // URL for generated audio in WAV format (Please note that for information security, generated audios will be cleared after 30 days. Please save them promptly.)
"duration_mp3": "string", // Total duration of the audio in MP3 format, unit: s
"duration_wav": "string" // Total duration of the audio in WAV format, unit: s
}
]
},
"final_unit_deduction": "string", // The deduction units of task
"created_at": 1722769557708, // Task creation time, Unix timestamp, unit: ms
"updated_at": 1722769557708 // Task update time, Unix timestamp, unit: ms
}
}Query Task (List)
GET https://platform.dataeyes.ai/kling/v1/audio/text-to-audioRequest Headers
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
Content-Type | string | Yes | application/json | Data Exchange Format |
Authorization | string | Yes | Authentication information, refer to API authentication |
Request Example
curl --request GET \
--url 'https://platform.dataeyes.ai/kling/v1/audio/text-to-audio?pageNum=1&pageSize=30' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json'Response Example
{
"code": 0, // Error codes; Specific definitions can be found in "Error Code"
"message": "string", // Error information
"request_id": "string", // Request ID, generated by the system, used to track requests and troubleshoot problems
"data": [
{
"task_id": "string", // Task ID, generated by the system
"task_status": "string", // Task status, Enum values: submitted, processing, succeed, failed
"task_status_msg": "string", // Task status message, displaying the failure reason when the task fails (such as triggering the platform's content risk control, etc.)
"task_info": { // Task creation parameters
"external_task_id": "string" // Customer-defined task ID
},
"task_result": {
"audios": [
{
"id": "string", // Audio ID; globally unique
"url_mp3": "string", // URL for generated audio in MP3 format (Please note that for information security, generated audios will be cleared after 30 days. Please save them promptly.)
"url_wav": "string", // URL for generated audio in WAV format (Please note that for information security, generated audios will be cleared after 30 days. Please save them promptly.)
"duration_mp3": "string", // Total duration of the audio in MP3 format, unit: s
"duration_wav": "string" // Total duration of the audio in WAV format, unit: s
}
]
},
"final_unit_deduction": "string", // The deduction units of task
"created_at": 1722769557708, // Task creation time, Unix timestamp, unit: ms
"updated_at": 1722769557708 // Task update time, Unix timestamp, unit: ms
}
]
}