Wan wan2.2-s2v image detection API reference-Alibaba Cloud Model Studio(Model Studio)-阿里云帮助中心

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

ImportantThis document applies only to the China (Beijing) region. You must use the API key of that region.

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

POST https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/api/v1/services/aigc/image2video/face-detect

Replace {WorkspaceId} with your actual workspace ID.

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.For local files, see Upload a file to get a temporary URL.	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

Replace {WorkspaceId} with your actual workspace ID.

curl 'https://{WorkspaceId}.cn-beijing.maas.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)

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

Response example (failed)

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

Error codes

For error solutions, see Error codes.