mingyan

Seedance X1 - 提交真人加白

提交真人图片素材处理，处理完成后可用于视频生成

POST/kyyReactApiServer/asset/seedance-x1/realPerson

Seedance X1 提交真人加白

提交真人图片素材处理。状态为 Active 后，可使用返回的素材引用创建视频任务。

所有请求都需要在请求头中包含 Bearer token：

cURL

Authorization: Bearer {{key}}

https://zcbservice.aizfw.cn/kyyReactApiServer

baseUrl 为所有对外 API 的公共前缀。当前页面 frontmatter 中的 api 字段展示的是完整请求地址，请在接入时以这里的 baseUrl 为统一前缀理解和拼接接口路径。

namestring必填

真人素材名称。

urlstring必填

真人图片公网 URL。

codeinteger

响应状态码，0 表示成功。

msgstring

响应消息，失败时返回错误说明。

data.officialIdstring

素材官方 ID，用于后续查询处理状态。

data.createdAtstring

素材创建时间，ISO 8601 格式。

data.assetRefstring

可用于创建任务的素材引用。提交后处理中时通常为 null。

data.namestring

素材名称。

data.urlstring

素材 URL。

data.statusstring

处理状态。提交成功后通常为 Processing。