digital human-wan2.2-s2v image detection API reference

wan2.2-s2v-detect checks whether an input image meets wan2.2-s2v input specifications. Important

This document applies only to the China (Beijing) region. To use this model, you need an API key from China (Beijing).

Model and pricing

Model	Unit price	Rate limit (shared by Alibaba Cloud account and RAM users)
Task submission RPS limit	Concurrent tasks
wan2.2-s2v-detect	$0.000574/image	5	No limit for sync APIs

Billing: You are charged per successful request, regardless of detection result. Failed requests are not billed.

Non-compliant images are still billed - the model executes the full detection flow before determining compliance.

HTTP API

This API checks whether an input image meets wan2.2-s2v portrait specifications.

Prerequisites

• Activate the service and obtain an API key.

• Set the API key as an environment variable.

Image detection API

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

Request parameters

Field	Type	Passing method	Required	Description	Example
Content-Type	String	Header	Yes	Request type: application/json.	application/json
Authorization	String	Header	Yes	The API key. The format is Bearer sk-xxx.	Bearer sk-1a**2b
model	String	Body	Yes	The name of the model to call.	wan2.2-s2v-detect
input.image_url	String	Body	Yes	The URL of the image to detect. - Supported formats: JPG, JPEG, PNG, BMP, WEBP. - Resolution: Width and height must be between 400 and 7,000 pixels. - Only publicly accessible HTTP or HTTPS links are supported for image uploads.	http://aaa/bbb.jpg

Response parameters

Field	Type	Description	Example
output.check_pass	Bool	Detection result: `true` = passed, `false` = failed.	true
output.humanoid	Bool	Whether a human portrait was detected: `true` = yes, `false` = no.	true
usage.image_count	Integer	Image count per request (always 1). You are charged per successful request, regardless of detection result. Failed requests are not billed. Non-compliant images are still billed - the model executes the full detection flow before determining compliance.	1
request_id	String	The unique ID of this request.	7574ee8f-38a3-4b1e-9280-11c33ab46e51

Request example

HELPCODEESCAPE-curl
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"
        }
    }'

Response example (passed)

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

Response example (failed)

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

Error codes

For error solutions, see Error messages.