创建自定义故事。 区别于推荐故事,自定义故事下面的文件列表由用户指定。
接口说明
请确保在使用该接口前,已充分了解 PDS 的收费方式和价格。
使用此功能须开通增值服务图片处理功能。故事相关接口限时免费。
用户通过传入指定文件列表创建自定义故事。其中故事类型和故事子类型用户可自定义,不再有约束。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
调试
授权信息
请求语法
POST /v2/image/create_customized_story HTTP/1.1
请求参数
|
名称 |
类型 |
必填 |
描述 |
示例值 |
| domain_id |
string |
是 |
||
| body |
object |
否 |
请求体 |
|
| drive_id |
string |
是 |
空间 id |
1 |
| story_type |
string |
是 |
故事类型。由用户自定义。 |
user_created |
| story_sub_type |
string |
是 |
故事子类型。由用户自定义。 |
user_created |
| story_name |
string |
是 |
故事名称。 长度不能超过 1024 字节。 |
test_name |
| story_cover |
object |
是 |
故事封面。该封面必须在故事文件列表中。 |
|
| file_id |
string |
是 |
文件 id |
63e5e4340f76cb3ead5f40f68163f0f967c1a7bf |
| revision_id |
string |
否 |
文件版本 id |
642a88d4aff041ee68fd4fc89beb80e1119da343 |
| story_files |
array<object> |
是 |
故事文件列表 |
|
|
object |
否 |
|||
| file_id |
string |
是 |
文件 id |
63e5e4340f76cb3ead5f40f68163f0f967c1a7bf |
| revision_id |
string |
否 |
文件版本 id |
642a88d4aff041ee68fd4fc89beb80e1119da343 |
custom_labels
deprecated
|
object |
否 |
自定义标签。 标签数量不能超过 20 个。 |
|
|
string |
否 |
自定义标签 |
label_value |
返回参数
|
名称 |
类型 |
描述 |
示例值 |
|
object |
返回参数 |
||
| drive_id |
string |
空间 id |
1 |
| story_id |
string |
故事 id |
9132e0d8-fe92-4e56-86c3-f5f112308003 |
示例
正常返回示例
JSON格式
{
"drive_id": "1",
"story_id": "9132e0d8-fe92-4e56-86c3-f5f112308003"
}
错误码
访问错误中心查看更多错误码。
变更历史
更多信息,参考变更详情。