AI 商品图


POST https://api.vidu.cn/ent/v2/ecommerce-img

请求头

Field	Value	描述
Content-Type	application/json	数据交换格式
Authorization	Token {your api key}	将{token}替换为提供给您的token

请求体

参数名称	类型	必填	参数描述
image	String	是	图像参数上传商品图，用于生成最终商品图像输出。支持以下格式与要求： - 只支持输入 1 张图 - 可传入图片 URL（确保公网可访问）或 Base 64 格式 - 支持格式： png、jpeg、jpg、webp - 图片宽度和高度均需大于 512 像素 - 图片宽高比小于2 - 图片的大小不得超过 10 MB - Base64 decode之后的字节长度需要小于 10MB，且编码必须包含适当的内容类型字符串，例如： data:image/png;base64,{base64_encode}
count	Int	是	输出图片的数量默认 4，可选值：1～4
background	String	可选	背景参数 - 用于指定预设背景 - 每次调用时，background 与 prompt 至少填写其中一个 - 可选值详情见文档：商品图预设背景
prompt	String	可选	文本提示词 - 通过文本提示词生成特定背景 - 每次调用时，background 与 prompt 至少填写其中一个
callback_url	String	可选	Callback 协议需要您在创建任务时主动设置 callback_url，请求方法为 POST，当视频生成任务有状态变化时，Vidu 将向此地址发送包含任务最新状态的回调请求。回调请求内容结构与查询任务API的返回体一致回调返回的"status"包括以下状态： - processing 任务处理中 - success 任务完成（如发送失败，回调三次） - failed 任务失败（如发送失败，回调三次）


curl -X POST -H "Authorization: Token {your_api_key}" -H "Content-Type: application/json" -d '
{
    "background": "clear_blue",
    "image": "input_your_image_url",
    "count": 4
}' https://api.vidu.cn/ent/v2/ecommerce-img

响应体

字段	类型	描述
task_id	String	Vidu 生成的任务ID
state	String	处理状态可选值： created 创建成功 queueing 任务排队中 processing 任务处理中 success 任务成功 failed 任务失败
image	String	本次调用的图像参数
count	Int	本次生成图片数量
background	String	本次调用的预设背景模板参数
prompt	String	本次调用的提示词参数
created_at	String	任务创建时间