CreateCustomizedStory - 创建自定义故事

更新时间:
复制 MD 格式

创建自定义故事。 区别于推荐故事,自定义故事下面的文件列表由用户指定。

接口说明

请确保在使用该接口前,已充分了解 PDS 的收费方式和价格。

使用此功能须开通增值服务图片处理功能。故事相关接口限时免费。

用户通过传入指定文件列表创建自定义故事。其中故事类型和故事子类型用户可自定义,不再有约束。

重要 通过该接口指定故事封面时,该封面文件必须存在于故事列表中,否则会返回错误。
重要 自定义故事列表中的文件类型只能为图片。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

调试

授权信息

当前API暂无授权信息透出。

请求语法

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"
}

错误码

访问错误中心查看更多错误码。

变更历史

更多信息,参考变更详情。