Wan wan2.2-s2v image detection API reference - Alibaba Cloud Model Studio

The wan2.2-s2v-detect model checks if an input image meets the input specifications of the wan2.2-s2v model.

Important

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

Model and pricing

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

Billing: You are charged for successful requests, regardless of the detection result. You are not charged for failed requests.

If an image is found to be non-compliant, you are still billed for the API call. This is because the model has already executed the complete detection flow.

HTTP API

This model checks whether an input image meets the portrait image specifications required by the wan2.2-s2v model.

Prerequisites

Activate the service and obtain an API key.
Set the API key as an environment variable.

Image detection API

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

Request parameters

Field	Type	Parameter 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. Image format: JPG, JPEG, PNG, BMP, and WEBP are supported. Image resolution: The width and height of the image 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	The detection result. `true` indicates that the check passed. `false` indicates that the check failed.	true
output.humanoid	Bool	Indicates whether a human portrait was detected. `true` indicates yes. `false` indicates no.	true
usage.image_count	Integer	The image count in this request, fixed at 1. Each successful request is billed, regardless of the detection result. Failed requests are not billed. If an image is found to be non-compliant, you are still billed for the API call. This is because the model has already executed the complete detection flow.	1
request_id	String	The unique ID of this request.	7574ee8f-38a3-4b1e-9280-11c33ab46e51

Request example

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)

{
    "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

If a model call fails and returns an error message, refer to Error messages for a solution.