创建推荐故事。 PDS 会根据请求参数中的故事类型和时间范围筛选 drive 空间下的图片和视频，将符合条件的图片、视频加入该故事的文件列表。 若没有符合条件的图片、视频，则会创建空故事。
接口说明
请确保在使用该接口前，已充分了解 PDS 的收费方式和价格。
使用此功能须开通增值服务图片处理功能。故事相关接口限时免费。
用户创建故事时可自己指定故事 id：
- 若指定故事 id：
- 若故事 id 不存在，则使用该 id 创建新故事；
- 若故事 id 存在，则会根据新条件生成故事并覆盖更新该故事；
- 若不指定 id，则会由 PDS 生成故事 id。
调试
您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。
授权信息
请求语法
POST /v2/image/create_story HTTP/1.1
请求参数
| 名称 | 类型 | 必填 | 描述 | 示例值 |
|---|---|---|---|---|
| body | object | 否 | 请求体 | |
| drive_id | string | 是 | 空间 id | 1 |
| story_id | string | 否 | 故事 id。由用户指定。 | 9132e0d8-fe92-4e56-86c3-f5f112308003 |
| story_type | string | 是 | 故事类型 枚举值：
| TagMemory |
| story_sub_type | string | 否 | 故事子类型。其值取决于故事类型，详情可见请求参数补充说明。 | Food |
| story_name | string | 否 | 故事名称。 长度不超过 1024 个字节。 | 美食 |
| story_start_time | string | 否 | 创建故事照片或视频的开始时间。RFC3339。 | 2016-12-30T16:00:00Z |
| story_end_time | string | 否 | 创建故事照片或视频的结束时间。RFC3339。 | 2022-12-30T16:00:00Z |
| min_image_count | long | 否 | 创建故事照片或视频文件最小个数。 须大于 0，小于等于 max_image_count，空值默认为 1。 | 1 |
| max_image_count | long | 否 | 创建故事照片或视频文件最大个数。 须小于等于 100，大于等于 min_image_count，空值默认 30。 | 30 |
custom_labelsdeprecated | object | 否 | 自定义标签。 标签数量不能超过 20 个。 | |
| string | 否 | 自定义标签 | label_value | |
| address | Address | 否 | 地址信息 |
故事类型
-
TimeMemory：时光故事
-
PeopleMemory：人物故事
-
TagMemory：标签故事
-
TravelMemory：旅行故事
故事子类型
TimeMemory：空
PeopleMemory：
- Solo：人物故事，单人故事。搜索数据集里人脸数目最多的人物，根据已做过的人脸聚类的结果生成人物故事，可支持通过时间参数 StoryStartTime 和 StoryEndTime 传入时间间隔，即在某段时间间隔内，照片数量最多的人物为候选人物，不会关注是否已有该人物的故事生成
TagMemory：
-
Food：美食标签故事
-
Pet：宠物标签故事
-
PetDog：宠物狗标签故事
-
PetCat：宠物猫标签故事
-
Scenery：风景标签故事
TravelMemory：空
返回参数
示例
正常返回示例
JSON格式
{
"drive_id": "1"
}错误码
访问错误中心查看更多错误码。