响应示例 状态码： 200 OK { "quota" : 100, "total" : 19, "offset" : 0, "count" : 10, "characters" : [ { "id" : "xiaoya_suit_grey_stand", "name" : "正装深色西装", "type" : 0, "gender" : 1, "posture" : 0, "create_time" : "2022-07-29T10:19:48Z", "update_time" : "2022-07-29T10:19:48Z", "photo_url" : "https://cbs-digital-human-cn-north-4.obs.cn-north-4.myhuaweicloud.com", "character_name" : "小娅", "train_status" : 2, "train_finish_time_estimate" : "2022-07-26T09:16:50Z" }, { "id" : "xiaoya_dress_white_stand", "name" : "正装白裙", "type" : 0, "gender" : 1, "posture" : 0, "create_time" : "2022-07-27T10:19:48Z", "update_time" : "2022-07-27T10:19:48Z", "photo_url" : "https://cbs-digital-human-cn-north-4.obs.cn-north-4.myhuaweicloud.com", "character_name" : "小娅", "train_status" : 2, "train_finish_time_estimate" : "2022-07-26T09:17:26Z" }, { "id" : "xiaoya_suit_black_stand", "name" : "正装黑裙", "type" : 0, "gender" : 1, "posture" : 0, "create_time" : "2022-07-26T12:19:48Z", "update_time" : "2022-07-26T10:19:48Z", "photo_url" : "https://cbs-digital-human-cn-north-4.obs.cn-north-4.myhuaweicloud.com", "character_name" : "小娅", "train_status" : 2, "train_finish_time_estimate" : "2022-07-26T09:10:24Z" }, { "id" : "xiaoya_dress_pink_stand", "name" : "休闲粉裙", "type" : 0, "gender" : 1, "posture" : 0, "create_time" : "2022-07-25T10:19:48Z", "update_time" : "2022-07-26T10:19:48Z", "photo_url" : "https://cbs-digital-human-cn-north-4.obs.cn-north-4.myhuaweicloud.com", "character_name" : "小娅", "train_status" : 2, "train_finish_time_estimate" : "2022-07-26T09:17:55Z" }, { "id" : "xiaoya_cheongsam_yellow_stand", "name" : "正装旗袍", "type" : 0, "gender" : 1, "posture" : 0, "create_time" : "2022-07-24T10:19:48Z", "update_time" : "2022-07-25T10:19:48Z", "photo_url" : "https://cbs-digital-human-cn-north-4.obs.cn-north-4.myhuaweicloud.com", "character_name" : "小娅", "train_status" : 2, "train_finish_time_estimate" : "2022-07-26T09:18:22Z" }, { "id" : "xiaoya_uniform_blue_stand", "name" : "正装蓝衬衫", "type" : 0, "gender" : 1, "posture" : 0, "create_time" : "2022-07-23T10:19:48Z", "update_time" : "2022-07-24T10:19:48Z", "photo_url" : "https://cbs-digital-human-cn-north-4.obs.cn-north-4.myhuaweicloud.com", "character_name" : "小娅", "train_status" : 2, "train_finish_time_estimate" : "2022-07-26T09:18:57Z" }, { "id" : "xiaoya_suit_white_sit_desk", "name" : "正装白裙(坐)", "type" : 0, "gender" : 1, "posture" : 3, "create_time" : "2022-07-22T10:19:48Z", "update_time" : "2022-07-23T10:19:48Z", "photo_url" : "https://cbs-digital-human-cn-north-4.obs.cn-north-4.myhuaweicloud.com", "character_name" : "小娅", "train_status" : 2, "train_finish_time_estimate" : "2022-07-26T09:20:23Z" }, { "id" : "xiaoya_suit_black_sit_desk", "name" : "正装黑裙(坐)", "type" : 0, "gender" : 1, "posture" : 3, "create_time" : "2022-07-21T09:19:48Z", "update_time" : "2022-07-23T09:19:48Z", "photo_url" : "https://cbs-digital-human-cn-north-4.obs.cn-north-4.myhuaweicloud.com", "character_name" : "小娅", "train_status" : 2, "train_finish_time_estimate" : "2022-07-22T15:03:00Z" }, { "id" : "xiaoya_dress_flower_sit_desk", "name" : "休闲花裙(坐)", "type" : 0, "gender" : 1, "posture" : 3, "create_time" : "2022-07-20T09:19:48Z", "update_time" : "2022-07-23T09:19:48Z", "photo_url" : "https://cbs-digital-human-cn-north-4.obs.cn-north-4.myhuaweicloud.com", "character_name" : "小娅", "train_status" : 2, "train_finish_time_estimate" : "2022-07-26T09:22:06Z" }, { "id" : "xiaoya_dress_flower_sit_chair", "name" : "休闲花裙(椅)", "type" : 0, "gender" : 1, "posture" : 2, "create_time" : "2022-07-19T10:19:48Z", "update_time" : "2022-07-21T10:19:48Z", "photo_url" : "https://cbs-digital-human-cn-north-4.obs.cn-north-4.myhuaweicloud.com", "character_name" : "小娅", "train_status" : 2, "train_finish_time_estimate" : "2022-07-26T09:23:09Z" } ] } 状态码： 400 Bad Request { "error_code" : "CBS.0003", "error_msg" : "This resource Id:[33dbe0e2-bb9b-xxx] does not exist." } 状态码： 500 Internal Server Error { "error_code" : "CBS.0004", "error_msg" : "Internal Server Error" }

响应参数 状态码： 200 表2 响应Body参数 参数 参数类型 描述 quota Integer 配额。 total Integer 总数。 offset Integer 偏移量。 count Integer 返回数量。 characters Array of Character objects 形象列表。 表3 Character 参数 参数类型 描述 create_time String 创建时间。 update_time String 更新时间。 character_name String 形象的个人姓名。 gender Integer 性别。0：男，1：女。 id String 形象id。 name String 形象名。 photo_url String 形象obs地址。 posture Integer 姿态。 0：站姿全身 1：站姿半身 2：坐姿全身 3：坐姿半身 train_finish_time_estimate String 估算的训练结束时间。 train_start_time String 训练开始时间。 train_status Integer 训练状态。 0：初始化 1：训练中 2：训练成功 3：训练失败 type Integer 形象类型。 0：预制形象 1：用户自定义形象 状态码： 400 表4 响应Body参数 参数 参数类型 描述 error_code String 错误码 CBS.XXXX。 error_msg String 错误详情。 状态码： 500 表5 响应Body参数 参数 参数类型 描述 error_code String 错误码 CBS.XXXX。 error_msg String 错误详情。

URI GET https://{endpoint}/v1/{project_id}/digital-human/characters?offset={offset}&limit={limit}&type={type}&train_status={train_status}&character_name={character_name} 表1 路径参数 参数 是否必选 参数类型 描述 endpoint 是 String 终端节点，即调用API的请求地址。 不同服务不同区域的endpoint不同，您可以从终端节点中获取。 例如，CBS服务在“华北-北京四”区域的“endpoint”为“cbs-ext.cn-north-4.myhuaweicloud.com”。 project_id 是 String 项目ID，用于资源隔离。请参见获取项目ID。 character_name 是 String 形象名称。 limit 是 String 大于等于1。 默认值：10。 offset 是 String 范围，大于等于0。 默认值：0。 train_status 是 Integer 训练状态。 0：训练中 1：预览视频生成中 2：成功 3：失败 默认值：2。 type 是 Integer 形象类型。 0：预制形象 1：用户自定义形象 默认值：0。

响应参数 状态码： 200 表2 响应Body参数 参数 参数类型 描述 create_time String 创建时间。 update_time String 更新时间。 character_name String 形象的个人姓名。 gender Integer 性别。0：男。1：女。 id String 形象id。 name String 形象名。 photo_url String 形象obs地址。 posture Integer 姿态。 0：站姿全身 1：站姿半身 2：坐姿全身 3：坐姿半身 train_finish_time_estimate String 估算的训练结束时间。 train_start_time String 训练开始时间。 train_status Integer 训练状态。 0：初始化 1：训练中 2：训练成功 3：训练失败 type Integer 形象类型。 0：预制形象 1：用户自定义形象 center_photo_url String 形象在中心时的图片obs 地址。 error_msg String 合成错误信息。 left_photo_url String 形象在左时的图片obs地址。如果为null，形象无法使用左右配置。 preview_video_url String 预览视频。 right_photo_url String 形象在右时的图片obs地址。如果为null，形象无法使用左右配置。 background_url String 抠图背景地址。 best_img_quality_preview_url String 显示效果最佳预览。 best_lip_sync_preview_url String 音唇同步最佳预览。 best_mouth_rec_preview_url String 嘴巴部分效果最佳。 charater_dimension CharacterDimension object 形象的高度和宽度{height:xxx, width:500} 参数待下架。 charater_position CharacterPosition object 形象位于背景的坐标{x:500, y:500} 参数带下架。 have_segment_data Boolean 是否有人像分割数据。 initial_video_url String 合成原始视频地址。 model Integer 0: best img quality 1: best lip sync 2: best mouth rec 表3 charater_position 参数 参数类型 描述 x Integer 从左上为0点出发的横坐标。 y String 从左上为0点出发的纵坐标。 表4 charater_dimension 参数 参数类型 描述 height String 角色的高度。 width String 角色的宽度。 状态码： 400 表5 响应Body参数 参数 参数类型 描述 error_code String 错误码 CBS.XXXX。 error_msg String 错误详情。 状态码： 500 表6 响应Body参数 参数 参数类型 描述 error_code String 错误码 CBS.XXXX。 error_msg String 错误详情。

响应示例 状态码： 200 OK { "id" : "xiaoya_suit_grey_stand", "name" : "正装深色西装", "type" : 0, "gender" : 1, "posture" : 0, "create_time" : "2022-07-29T10:19:48Z", "update_time" : "2022-07-29T10:19:48Z", "photo_url" : "https://cbs-digital-human-cn-north-4.obs.cn-north-4.myhuaweicloud.com", "character_name" : "小娅", "train_status" : 2, "train_finish_time_estimate" : "2022-07-26T09:16:50Z", "preview_video_url" : "https://cbs-digital-human-cn-north-4.obs.cn-north-4.myhuaweicloud.com", "left_photo_url" : "https://cbs-digital-human-cn-north-4.obs.cn-north-4.myhuaweicloud.com", "right_photo_url" : "https://cbs-digital-human-cn-north-4.obs.cn-north-4.myhuaweicloud.com", "center_photo_url" : "https://cbs-digital-human-cn-north-4.obs.cn-north-4.myhuaweicloud.com"} 状态码： 400 Bad Request { "error_code" : "CBS.0003", "error_msg" : "This resource Id:[33dbe0e2-bb9b-4efc-xxx] does not exist."} 状态码： 500 Internal Server Error { "error_code" : "CBS.0004", "error_msg" : "Internal Server Error"}

URI GET https://{endpoint}/v1/{project_id}/digital-human/characters/{character_id} 表1 路径参数 参数 是否必选 参数类型 描述 endpoint 是 String 终端节点，即调用API的请求地址。 不同服务不同区域的endpoint不同，您可以从终端节点中获取。 例如，CBS服务在“华北-北京四”区域的“endpoint”为“cbs-ext.cn-north-4.myhuaweicloud.com”。 project_id 是 String 项目ID，用于资源隔离。请参见获取项目ID。 character_id 是 String 形象id。可通过调用获取形象列表接口获取。