# 文生音效

**方法**: `POST`
**路径**: `/kling/v1/audio/text-to-audio`

本文档不实时更新，完整版请查看官方文档：<https://app.klingai.com/cn/dev/document-api/apiReference/model/textToAudio>

## 请求参数

### Header 参数

```text
Authorization
string
可选
默认值:
Bearer {{YOUR_API_KEY}}
```

### Body 参数 application/json

```text
prompt
string
必需
文本提示词  内容长度不超过200字符
duration
integer
必需
生成音频的时长  取值范围： 3.0秒至10.0秒，支持小数点后一位精度
示例
{
"prompt"
:
"文本提示词,内容长度不超过200字符"
,
"duration"
:
3.0
}
```

## 请求示例代码

### Shell

```bash
curl --location --request POST '/kling/v1/audio/text-to-audio' \
--header 'Authorization: Bearer {{YOUR_API_KEY}}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "prompt": "文本提示词,内容长度不超过200字符",
    "duration": 3.0
}'
```

## 返回响应

### 🟢 200 成功

**内容类型**: `application/json`

#### 响应结构

```text
code
integer
必需
错误码；具体定义错误码
message
string
错误信息
必需
request_id
string
必需
请求ID，系统生成，用于跟踪请求、排查问题
data
object
必需
task_id
string
必需
任务ID，系统生成
task_status
enum<string>
必需
任务状态，枚举值：submitted（已提交）、processing（处理中）、succeed（成功）、failed（失败）
枚举值:
submitted（已提交
processing（处理中）
succeed（成功）
failed（失败）
created_at
integer
必需
任务创建时间，Unix时间戳、单位ms
updated_at
integer
必需
任务更新时间，Unix时间戳、单位ms
```

#### 示例

```json
{
  "code": 0, //错误码；具体定义见错误码
  "message": "string", //错误信息
  "request_id": "string", //请求ID，系统生成，用于跟踪请求、排查问题
  "data":{
      "task_id": "string", //任务ID，系统生成
      "task_info":{ //任务创建时的参数信息
          "external_task_id": "string" //客户自定义任务ID
      }, 
      "task_status": "string", //任务状态，枚举值：submitted（已提交）、processing（处理中）、succeed（成功）、failed（失败）
      "created_at": 1722769557708, //任务创建时间，Unix时间戳、单位ms
      "updated_at": 1722769557708 //任务更新时间，Unix时间戳、单位ms
  }
}

```