wan2.7-image-pro
Submit an async wan2.7-image-pro image generation task. Returns a task_id to poll via the status endpoint.
Authorization
BearerAuth
AuthorizationBearer <token>
使用 Bearer Token 认证。
格式: Authorization: Bearer sk-xxxxxx
In: header
Request Body
application/json
model*string
模型名，固定为 wan2.7-image-pro。
prompt?string
图片描述，最长 5000 字符；没有输入图片时必填。
Length
length <= 5000image?string
单张参考图 URL，可与 images 合并使用。
Format
uriimages?array<string>
image 与 images 合计最多 9 张参考图。
Items
items <= 9n?integer
生成数量；普通模式最多 4，连续组图模式最多 12。
Range
1 <= value <= 12size?string
输出尺寸，支持比例、1K / 2K / 条件允许的 4K 或像素尺寸。
resolution?string
输出分辨率。
Value in
"1K" | "2K" | "4K"negative_prompt?string
反向提示词。
watermark?boolean
是否添加水印。
seed?integer
随机种子。
Range
0 <= value <= 2147483647thinking_mode?boolean
是否开启思考模式。
enable_sequential?boolean
是否开启连续组图。
bbox_list?array<array<array<integer>>>
与输入图片一一对应的框选列表；每张图最多两个四坐标框。
Array Item (array<array<integer>>)
Array Item (array<integer>)
color_palette?array<object>
颜色主题；比例必须合计为 100%，不能用于连续组图。
Items
3 <= items <= 10Array Item (object)
hex*string
十六进制颜色。
Match
^#[0-9A-Fa-f]{6}$ratio*string
百分比，例如 50%。
Match
^(100(?:\.0+)?|(?:\d|[1-9]\d)(?:\.\d+)?)%$[key: string]?never
[key: string]?never
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
curl -X POST "https://api.apimp.ai/api/generate/submit" \ -H "Content-Type: application/json" \ -d '{ "model": "wan2.7-image-pro", "prompt": "A cinematic mountain village at sunrise" }'{
"code": 200,
"data": {
"task_id": "task_0VDknz6qRwvH5Y5aDAt6mN8pRShzLb6X",
"status": "not_started",
"created_time": "2026-06-18T09:21:26",
"error_message": null
}
}{
"code": 400,
"error": {
"message": "field `prompt` is required when no input image is provided",
"type": "invalid_request_error"
}
}{
"code": 400,
"error": {
"message": "string",
"type": "invalid_request_error"
}
}{
"code": 400,
"error": {
"message": "string",
"type": "invalid_request_error"
}
}{
"code": 400,
"error": {
"message": "string",
"type": "invalid_request_error"
}
}{
"code": 400,
"error": {
"message": "string",
"type": "invalid_request_error"
}
}How is this guide?
Last updated on