相关文章推荐
重感情的机器人  ·  鞋靴设计效果图技法_百度百科·  9 月前    · 
重感情的机器人  ·  鞋靴模特、鞋靴模特生成_大模型服务平台百炼( ...·  9 月前    · 
重感情的机器人  ·  鞋靴样板设计与制作_百度百科·  9 月前    · 
小百科  ›  鞋靴模特、鞋靴模特生成_大模型服务平台百炼(Model Studio)-阿里云 ...
实用鞋靴设计（书籍） string api接口
重感情的机器人
9 月前
鞋靴模特API参考

鞋靴模特API参考

更新时间：
产品详情
我的收藏

本文介绍鞋靴模特模型的输入输出参数。鞋靴模特模型支持输入多视角鞋靴系列图片，同时对输入模特模板图的鞋子区域进行鞋靴 AI 试穿，实现模特鞋靴布局重绘生成，最终生成图片的效果布局自然、细节丰富、画面细腻、试穿结果逼真。可用于模特商品图设计、新鞋 AI 试穿、模特穿戴布局重绘等场景。

相关指南 ： 鞋靴模特

模型概览

模型名

模型简介

免费额度

计费单价

限流（含主账号与 RAM 子账号）

任务下发接口 QPS 限制

同时处理中任务数量

shoemodel-v1

鞋靴模特支持输入多视角鞋靴系列图片，同时对输入模特模板图的鞋子区域进行鞋靴 AI 试穿，实现模特鞋靴布局重绘生成，最终生成图片的效果, 布局自然、细节丰富、画面细腻、试穿结果逼真。可用于模特商品图设计、新鞋 AI 试穿、模特穿戴布局重绘等场景。

免费额度 ：500 张

领取方式 ：开通阿里云百炼大模型服务后，自动发放

有效期 ：180 天

限时免费

2

1

前提条件

您需要已 获取 API Key 并 配置 API Key 到环境变量 。

HTTP 调用

为了减少等待时间并且避免请求超时，服务采用异步方式提供。您需要发起两个请求：

  • 创建任务 ：首先发送一个请求创建鞋靴模特任务，该请求会返回任务 ID。

  • 根据任务 ID 查询结果 ：使用上一步获得的任务 ID，查询模型生成的结果。

创建任务

POST https://dashscope.aliyuncs.com/api/v1/services/aigc/virtualmodel/generation/

请求头（Headers）

鞋靴模特试穿 

curl --location 'https://dashscope.aliyuncs.com/api/v1/services/aigc/virtualmodel/generation/' \
--header 'X-DashScope-Async: enable' \
--header "Authorization: Bearer $DASHSCOPE_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
    "model": "shoemodel-v1",
    "input": {
        "template_image_url": "http://xxx/1.jpg",
        "shoe_image_url": ["http://xxx/2.jpg"]
    "parameters": 
        "n": 1
}'

Authorization string 必选

推荐您使用百炼 API-Key，也可填 DashScope API-Key。例如：Bearer d1xxx2a。

X-DashScope-Async string 必选

是否使用 DashScope 异步调用。HTTP 只支持异步调用，设置为 enable 。

Content-Type string 必选

请求内容类型。固定为 application/json 。

请求体（Request Body）

model string 必选

调用模型。鞋靴模特生成模型为 shoemodel-v1 。

parameters Integer 必选

图片生成的数量，目前支持 1~4 张，默认值 1。

input object 必选

输入图像的基本信息，比如图像 URL 地址。

属性

template_image_url string 必选

用户上传模板模特图片的 URL 地址。

图像限制：

  • 图片大小建议小于 5M。

  • 图像格式：jpg、png、jpeg、bmp、webp、avif。

  • 图像比例：宽高比小于 3:2 且宽高比推荐为 4:3。

shoe_image_url list 必选

用户上传的鞋靴多视角图片地址。

  • 图片大小建议小于 5M。

  • 图像格式：jpg、png、jpeg、bmp、webp、avif。

  • 图像比例：宽高比小于 3:2，推荐为 4:3，且宽高比尽量和 templace_image_url 保持一致。

  • 多视角图片个数小于 3。

scale float 可选

控制生成强度。

范围在[2.0,8.0]，默认为 5.0，数值越大，颜色越鲜亮。

响应

正常响应 

{
    "output": {
	"task_id": "d76ec1e8-ea27-4038-8913-xxxxxxxxxxxx", 
        "task_status": "PENDING"
    "request_id": "7574ee8f-38a3-4b1e-9280-11c33ab46e51"
}

异常响应 

{
    "code":"InvalidApiKey",
    "message":"Invalid API-key provided.",
    "request_id":"fb53c4ec-1c12-4fc4-a580-cdb7c3261fc1"
}

output object

任务输出信息。

属性

task_id string

任务 id。

task_status string

任务状态。

  • PENDING：排队中

  • RUNNING：处理中

  • SUSPENDED：挂起

  • SUCCEEDED：执行成功

  • FAILED：执行失败

code string

任务执行失败的错误码。

message string

任务执行失败的详细信息。

request_id string

请求唯一标识。可用于请求明细溯源和问题排查。

根据任务 ID 查询结果

GET https://dashscope.aliyuncs.com/api/v1/tasks/{task_id}

请求头（Headers）

获取任务结果 

curl --location --request GET 'https://dashscope.aliyuncs.com/api/v1/tasks/{task_id}' \
--header "Authorization: Bearer $DASHSCOPE_API_KEY"

Authorization string 必选

推荐使用百炼 API-Key，也可填 DashScope API-Key。例如：Bearer d1xxx2a。

URL 路径参数（Path parameters）

task_id string 必选

任务 id。

响应

任务执行成功 

{
    "request_id":"<your request id>",
    "output":{
        "task_id":"<your task id>",
        "task_status":"SUCCEEDED",
        "submit_time":"2024-05-16 13:50:xx.xxx",
        "scheduled_time":"2024-05-16 13:50:xx.xxx",
        "end_time":"2024-05-16 13:50:xx.xxx",
        "error_message":"Success",
        "start_time":"2024-05-16 13:50:xx.xxx",
        "model_index":0,
        "error_code":0,
        "result_url":"http://oss.aliyuncs.com/xxx/abc.jpg"
    "usage":{
        "image_count":1
}

任务执行中 

{
    "request_id":"e5d70b02-ebd3-98ce-9fe8-759d7d7b107d",
    "output":{
        "task_id":"86ecf553-d340-4e21-af6e-a0c6a421c010",
        "task_status":"RUNNING",
        "task_metrics":{
            "TOTAL":1,
            "SUCCEEDED":1,
            "FAILED":0
}

任务执行失败 

{
  "request_id": "<your request id>",
  "output": {
    "task_id": "<your task id>",
    "task_status": "FAILED",
    "submit_time": "2024-05-16 13:50:xx.xxx",
    "scheduled_time": "2024-05-16 13:50:xx.xxx",
    "end_time": "2024-05-16 13:50:xx.xxx",
    "code": "InvalidImageResolution",
    "message": "The input image resolution is too large or small"
  "usage": {
    "image_num": 0
}

output object

任务输出信息。

属性

task_id string

任务 id。

task_status string

任务状态。

  • PENDING：排队中

  • RUNNING：处理中

  • SUSPENDED：挂起

  • SUCCEEDED：执行成功

  • FAILED：执行失败

task_metrics object

任务信息统计指标。

属性

TOTAL integer

总的任务数。

SUCCEEDED integer

任务状态为成功的任务数。

FAILED integer

任务状态为失败的任务数。

submit_time string

任务提交时间。

scheduled_time string

任务排期执行时间。

end_time string

任务完成时间。

result_url string

输出图片 url。

code string

任务执行失败的错误码。

message string

任务执行失败的详细信息。

usage object

输出信息统计。

属性

image_count integer

模型生成图像的数量。

request_id string

请求唯一标识。可用于请求明细溯源和问题排查。

错误码

如果模型调用失败并返回报错信息，请参见 错误码 进行解决。

此 API 还有特定状态码，具体如下所示。

HTTP 状态码

接口错误码（code）

接口错误信息（message）

含义说明

400

InvalidParameter

Required parameter(s) missing or invalid, please check the request parameters.（可根据实际情况修改）

接口调用参数不合法

400

InvalidFile.Content

The input image has no human body or has unclear human body. Please upload other image.

输入图片中人体不完整或者没有人体

400

InvalidParameter

The request is missing required parameters or in a wrong format, please check the parameters that you send.

入参格式不对

400

InvalidURL

The request URL is invalid, please check the request URL is available and the request image format is one of the following types: JPEG, JPG, PNG, BMP, and WEBP.

输入图片下载失败，请检查网络或者输入格式

400

InvalidFile.Resolution

The image resolution is invalid, please make sure that the aspect ratio is smaller than 3:2, and largest length of image is smaller than 4096.

上传图片大小不符合要求

500

InternalError.Algo

An internal error occurs during computation, please try this model later.

算法运行错误

 
推荐文章
重感情的机器人  ·  鞋靴设计效果图技法_百度百科
9 月前
重感情的机器人  ·  鞋靴模特、鞋靴模特生成_大模型服务平台百炼(Model Studio)-阿里云 ...
9 月前
重感情的机器人  ·  鞋靴样板设计与制作_百度百科
9 月前
今天看啥   ·   Py中国   ·   codingpro   ·   小百科   ·   link之家   ·   卧龙AI搜索
删除内容请联系邮箱 2879853325@qq.com
小百科 - 百科知识指南
© 2024 ~ 沪ICP备11025650号