数字人wan2.2-s2v图像检测API参考

数字人wan2.2-s2v-detect 模型,用于检测输入图片是否符合 wan2.2-s2v 模型的输入规范。

模型与价格

模型名称

计费单价

限流(主账号与RAM子账号共用)

免费额度(查看)

任务下发接口RPS限制

同时处理中任务数量

wan2.2-s2v-detect

0.004元/张

5

同步接口无限制

200

HTTP调用接口

该模型用于检测输入的图片是否满足“wan2.2-s2v”所需的人物肖像图片规范。

前提条件

图像检测接口

POST https://dashscope.aliyuncs.com/api/v1/services/aigc/image2video/face-detect

入参描述

字段

类型

传参方式

必选

描述

示例值

Content-Type

String

Header

请求类型:application/json。

application/json

Authorization

String

Header

API-Key,格式为 Bearer sk-xxx。

Bearer sk-1a**2b

model

String

Body

指定调用的模型名称。

wan2.2-s2v-detect

input.image_url

String

Body

待检测的图像 URL。

  • 图像格式:支持jpg,jpeg,png,bmp,webp。

  • 图像分辨率:图像的宽度和高度范围为[400, 7000]像素。

  • 上传图片仅支持公网可访问的 HTTP/HTTPS 链接。本地文件请参见上传文件获取临时URL

http://aaa/bbb.jpg

出参描述

字段

类型

描述

示例值

output.check_pass

Bool

检测结果。true 表示通过,false 表示不通过。

true

output.humanoid

Bool

是否检测到人像:true 表示是,false 表示否。

true

usage.image_count

Integer

本次请求检测的图片数量,固定为1。

1

request_id

String

本次请求的唯一ID。

7574ee8f-38a3-4b1e-9280-11c33ab46e51

请求示例

curl 'https://dashscope.aliyuncs.com/api/v1/services/aigc/image2video/face-detect' \
--header "Authorization: Bearer $DASHSCOPE_API_KEY" \
--header 'Content-Type: application/json' \
--data-raw '{
    "model": "wan2.2-s2v-detect",
    "input": {
        "image_url": "https://img.alicdn.com/imgextra/i3/O1CN011FObkp1T7Ttowoq4F_!!6000000002335-0-tps-1440-1797.jpg"
        }
    }'

响应示例(通过)

{
    "output":{
        "check_pass": true,
        "humanoid": true
    },
    "usage":{
        "image_count":1
    },
    "request_id":"c56f62df-724e-9c19-96bd-xxxxxx"
}

响应示例(不通过)

{
    "output":{
        "check_pass": false,
        "code": "",
        "message": "",
    },
    "usage":{
        "image_count":1
    },
    "request_id":"c56f62df-724e-9c19-96bd-xxxxxx"
}

计费与限流

计费规则

  • 计费项:按成功生成的 图像张数 计费,采用按量后付费模式。

  • 计费公式:费用 = 计费单价 × 图像张数

  • 抵扣顺序:优先消耗免费额度。额度用尽后,默认转为按量付费。

    • 您可开启“免费额度用完即停”功能,以避免免费额度耗尽后产生额外费用。详情请参见免费额度

  • 失败不计费:模型调用失败或处理错误不产生任何费用,也不消耗免费额度。

免费额度

关于免费额度的领取、查询、使用方法等详情,请参见免费额度

调用量查询

模型调用完约一小时后,请在模型观测页面,查看调用量、调用次数、成功率等指标。

限流

模型限流规则及常见问题,请参见限流

错误码

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