> ## 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.

# 电商一键成片

> 商品图快速生成广告视频

## 概述

电商一键成片（ad-one-click）将商品图/模特图快速生成完整广告视频，包含：

* 自动生成分镜
* 生成旁白与背景音乐
* 合成最终成片

> \[!NOTE]
>
> * **本平台接口**：`POST https://models.hingnet.com.cn/vidu/ent/v2/ad-one-click`
> * **官方接口**：`POST https://api.vidu.cn/ent/v2/ad-one-click`，详见 [官方 API 文档](https://platform.vidu.cn/docs/one-click-ad-film)

## 创建成片任务

```bash theme={null}
curl -X POST "https://models.hingnet.com.cn/vidu/ent/v2/ad-one-click" \
  -H "Authorization: Bearer <HingNet AI Token>" \
  -H "Content-Type: application/json" \
  -d '{
    "images": [
      "https://your.cdn.com/product-1.jpg",
      "https://your.cdn.com/product-2.jpg"
    ],
    "prompt": "简洁风格的商品展示广告，突出材质与质感。",
    "duration": 15,
    "aspect_ratio": "16:9",
    "language": "zh",
    "creative": false
  }'
```

### 请求参数

| 参数             | 类型     | 必填 | 说明                         |
| -------------- | ------ | -- | -------------------------- |
| `images`       | array  | ✅  | 商品图 1–7 张（URL 或 Base64）    |
| `prompt`       | string | ❌  | 视频风格描述                     |
| `duration`     | int    | ❌  | 时长 8–60 秒，默认 15            |
| `aspect_ratio` | string | ❌  | 比例：`1:1` / `16:9` / `9:16` |
| `language`     | string | ❌  | 语言：`zh` / `en`             |
| `creative`     | bool   | ❌  | 是否生成创意片段                   |

## 查询任务结果

```bash theme={null}
curl -X GET "https://models.hingnet.com.cn/vidu/ent/v2/tasks/$TASK_ID/creations" \
  -H "Authorization: Bearer <HingNet AI Token>"
```

## 查询子任务列表

```bash theme={null}
curl -X GET "https://models.hingnet.com.cn/vidu/ent/v2/ad-one-click/$TASK_ID" \
  -H "Authorization: Bearer <HingNet AI Token>"
```

返回包含：

* `storyboards`：分镜任务与视频结果
* `narration_records`：旁白任务
* `bgm_records`：背景音乐任务
* `completed_creation_records`：合成成片任务

## 编辑分镜/旁白/背景音乐

```bash theme={null}
curl -X POST "https://models.hingnet.com.cn/vidu/ent/v2/ad-one-click/edit" \
  -H "Authorization: Bearer <HingNet AI Token>" \
  -H "Content-Type: application/json" \
  -d '{
    "ad_one_click_task_id": "YOUR_TASK_ID",
    "type": "generate_narration",
    "prompt": "这是一段简短的中文旁白，突出产品卖点。"
  }'
```

| type 值               | 说明       | 额外参数                     |
| -------------------- | -------- | ------------------------ |
| `generate_narration` | 重新生成旁白   | -                        |
| `generate_bgm`       | 重新生成背景音乐 | -                        |
| `generate_video`     | 重新生成分镜视频 | `storyboard_video_index` |

## 合成成片

```bash theme={null}
curl -X POST "https://models.hingnet.com.cn/vidu/ent/v2/ad-one-click/compose" \
  -H "Authorization: Bearer <HingNet AI Token>" \
  -H "Content-Type: application/json" \
  -d '{
    "ad_one_click_task_id": "YOUR_TASK_ID",
    "video_task_ids": ["VIDEO_TASK_ID_1", "VIDEO_TASK_ID_2"],
    "bgm_task_id": "BGM_TASK_ID",
    "narration_task_id": "NARRATION_TASK_ID"
  }'
```

合成任务提交后，可继续使用 **查询任务结果** 或 **查询子任务列表** 接口跟踪状态。