创建文生音效任务

POST/v1/audio/text-to-audio

用文字描述生成 3–10 秒的音效。

项	值
模式	异步（提交 → 轮询 `GET /v1/audio/text-to-audio/{id}`，见查询文生音效任务）
计费	每次成功计费一次

快速开始

curl https://api.vibelab.me/v1/audio/text-to-audio \
  -H "Authorization: Bearer $LOOPTOKEN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "春节庆祝时的烟花声",
    "duration": 3
  }'

响应示例：

{
  "code": 0,
  "message": "SUCCEED",
  "request_id": "6a0d571e-d36c-4811-bb2b-698c94b19a8c",
  "data": {
    "task_id": "893605946402811985",
    "task_status": "submitted",
    "task_info": {
      "external_task_id": "your-id"
    },
    "created_at": 1722769557708,
    "updated_at": 1722769557708
  }
}

请求参数

请求头

参数	类型	必填	默认	说明
`Authorization`	string	是	-	`Bearer $LOOPTOKEN_API_KEY`
`Content-Type`	string	是	-	`application/json`

请求体

参数	类型	必填	默认	说明
`prompt`	string	是	-	音效描述，不超过 200 个字符
`duration`	number	是	-	时长，3.0–10.0 秒，最多一位小数
`callback_url`	string	否	-	任务状态变化时的 HTTPS 回调地址
`external_task_id`	string	否	-	自定义任务 ID，同一账号下不可重复

响应

字段	类型	说明
`code`	integer	`0` 表示成功，其余见错误
`message`	string	错误信息
`request_id`	string	请求 ID，排查问题时提供
`data.task_id`	string	任务 ID
`data.task_status`	string	`submitted`、`processing`、`succeed`、`failed`
`data.task_info.external_task_id`	string	创建时传入的自定义任务 ID
`data.created_at`、`data.updated_at`	integer	Unix 毫秒时间戳

计费

每次成功计费一次；任务失败全额退回。

错误

本页参数校验返回 400 / 1201，message 原文如下：

HTTP	`code`	触发场景	处理
400	`1201`	`prompt is required and must be a string`	传非空 `prompt`
400	`1201`	`prompt must not exceed 200 characters`	缩短描述
400	`1201`	`duration must be a number between 3.0 and 10.0 with at most one decimal`	传 `3.0`–`10.0`，最多一位小数

通用错误（鉴权、余额、并发、回调地址、上游错误）见 Kling 错误。

注意事项

与官方的差别 → 响应不返回 final_unit_deduction、final_balance_deduction；callback_url 由 LoopToken 投递，external_task_id 在你的账号范围内去重。

创建文生音效任务

本页内容