POST
图片换装

Authorizations

X-Legacy-Token
string
header
required

调用业务接口时携带的访问 Token;请先通过获取访问 Token 接口生成。

Body

application/json

服装替换任务的请求参数。服装图片参数应与 garment_type 指定的服装类型一致。

garment_type
enum<string>
required

服装替换类型:top 为上装,bottom 为下装,full 为连体服,suit 为套装。

Available options:
top,
bottom,
full,
suit
model_url
string<uri>
required

待换装模特图片的可访问 URL。

top_url
string<uri>

上装图片的可访问 URL;替换上装或套装时使用。

bottom_url
string<uri>

下装图片的可访问 URL;替换下装或套装时使用。

full_url
string<uri>

连体服图片的可访问 URL;替换连体服时使用。

Response

200 - application/json

业务响应;请同时检查 success 与 code

接口处理成功时返回的统一业务响应信封。

requestId
string
required

本次请求的唯一追踪 ID,用于排查问题。

success
boolean
required

业务是否处理成功;成功响应固定为 true。

message
string
required

本次业务处理结果的中文提示信息。

code
integer
required

业务状态码;应与 success 一并判断,不等同于 HTTP 状态码。

data
object
required

异步任务创建结果。请保存 task_id,并通过对应的查询接口获取最终结果。