> ## Documentation Index
> Fetch the complete documentation index at: https://docs.hingnet.com.cn/llms.txt
> Use this file to discover all available pages before exploring further.

# 可控文生音效

> 基于时间轴生成可控时序音效（不支持 BGM）

## 概述

可控文生音效（timing2audio）用于基于时间轴生成多段音效事件，支持多个事件重叠。该能力仅生成音效，不支持输出背景音乐（BGM）。

> \[!NOTE]
>
> * **本平台接口**：`POST https://models.hingnet.com.cn/vidu/ent/v2/timing2audio`
> * **官方接口**：`POST https://api.vidu.cn/ent/v2/timing2audio`

## 请求参数

| 参数               | 类型     | 必填 | 说明                   |
| ---------------- | ------ | -- | -------------------- |
| `model`          | string | ✅  | 模型名：`audio1.0`       |
| `duration`       | float  | ❌  | 音频时长，默认 10，范围 2–10 秒 |
| `timing_prompts` | array  | ✅  | 音效事件数组               |
| `seed`           | int    | ❌  | 随机种子                 |
| `callback_url`   | string | ❌  | 回调地址                 |

### timing\_prompts 事件字段

| 字段       | 类型     | 必填 | 说明                   |
| -------- | ------ | -- | -------------------- |
| `from`   | float  | ✅  | 事件起始时间（秒）            |
| `to`     | float  | ✅  | 事件结束时间（秒）            |
| `prompt` | string | ✅  | 事件描述，单条提示词 ≤ 1500 字符 |

> \[!IMPORTANT]
> `from` 与 `to` 必须在 `[0, duration]` 区间内，且 `from < to`。

## 示例

```bash theme={null}
curl -X POST "https://models.hingnet.com.cn/vidu/ent/v2/timing2audio" \
  -H "Authorization: Bearer <HingNet AI Token>" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "audio1.0",
    "duration": 10,
    "timing_prompts": [
      {
        "from": 0.0,
        "to": 3.0,
        "prompt": "清晨的鸟叫声"
      },
      {
        "from": 3.0,
        "to": 6.0,
        "prompt": "远处传来火车驶过的声音"
      },
      {
        "from": 5.0,
        "to": 9.5,
        "prompt": "海浪轻轻拍打沙滩"
      }
    ],
    "seed": 0
  }'
```

## 返回示例

```json theme={null}
{
  "task_id": "your_task_id_here",
  "state": "created",
  "model": "audio1.0",
  "duration": 10,
  "timing_prompts": [
    {
      "from": 0.0,
      "to": 3.0,
      "prompt": "清晨的鸟叫声"
    }
  ],
  "seed": 0,
  "credits": 0,
  "created_at": "2025-01-01T10:00:00.000Z"
}
```

## 计费说明

| 能力     | 时长      | 积分消耗  |
| ------ | ------- | ----- |
| 可控文生音效 | 小于 5 秒  | 10 积分 |
| 可控文生音效 | 小于 10 秒 | 20 积分 |

## 查询结果

任务创建成功后，通过 [任务查询](/vidu/video-query) 接口获取最终结果。