wan2.2-s2v image detection API reference

Model and pricing

Model	Unit price	Rate limit (shared by Alibaba Cloud account and RAM users)		Free quota(View)
Model	Unit price	Task submission RPS limit	Concurrent tasks	Free quota(View)
wan2.2-s2v-detect	CNY 0.004/image	5	No limit for sync APIs	200 images

Billing items: 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.
Deduction order: The free quota is consumed first. After depletion, billing switches to pay-as-you-go automatically. To prevent charges after quota depletion, enable "Stop when the free quota is exhausted". For more information, see free quota.

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.

​Model and pricing

​HTTP API

​Prerequisites

​Image detection API

​Request parameters

​Response parameters

​Request example

​Response example (passed)

​Response example (failed)

​Error codes