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

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

Important

This document applies only to the China (Beijing) region. Use an API key from this region.

Model and pricing

Model name	Billing unit price	Throttling (shared by Alibaba Cloud account and RAM users)		Free quota (View)
		RPS limit for task submission API	Number of concurrent tasks
wan2.2-s2v-detect	CNY 0.004/image	5	No limit for sync APIs	200 images

Billing item: You are charged for each successful request, regardless of whether the detection passes. Failed requests are not charged.

If an image fails the detection due to non-compliance, the API call is still charged because the model has completed the full detection process.
Offset order: The free quota is consumed first. After the free quota is exhausted, billing defaults to pay-as-you-go. Enable the "Stop when free quota is used up" feature to avoid extra charges. For more information, see Free quota.

HTTP API call

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

Prerequisites

You have activated the service and obtained an API key. For more information, see Obtain an API key and API host.
You have configured the environment variable. For more information, see Configure the API key as an environment variable (to be deprecated and merged into Configure API key).

Image detection API

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

Input 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. Format: 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 be detected. Image format: JPG, JPEG, PNG, BMP, and WEBP are supported. Image resolution: The width and height of the image must be within the range of [400, 7000] pixels. Only HTTP/HTTPS links accessible over the public network are supported. For a local file, upload the file to get a temporary URL.	http://aaa/bbb.jpg

Response parameters

Field	Type	Description	Example
output.check_pass	Bool	The detection result. `true` indicates that the detection passed. `false` indicates that the detection failed.	true
output.humanoid	Bool	Indicates whether a human portrait was detected. `true` indicates yes. `false` indicates no.	true
usage.image_count	Integer	The number of images detected in this request. The value is fixed at 1 for billing purposes. You are charged for each successful request, regardless of whether the detection passes. Failed requests are not charged. If an image fails the detection due to non-compliance, the API call is still charged because the model has completed the full detection process.	1
request_id	String	The unique ID of the 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 the model call fails and returns an error message, see Error messages to resolve the issue.