Wan Image Generator API documentation

Generate images with Wan Image Generator (Alibaba). Supports both text and image input modes.

Endpoints

Contract item	Value
Capability	`wan-image-generator`
Submit	`POST https://vidmage.ai/api/v1/wan-image-generator/submit`
Query	`POST https://vidmage.ai/api/v1/wan-image-generator/query`
Task identifier	`taskId`
Result field	`imageUrl`

Authenticate with Authorization: Bearer YOUR_API_KEY. Save the task identifier and query the same capability. Use a stable Idempotency-Key for submission retries.

Product guide: Wan Image API

Parameters and input rules

Field	Type	Required	Default	Meaning and limits
`prompt`	`string`	Yes	Not specified	Text prompt describing the image to generate (max 5000 chars). For an unspecified character or figurine, use an original non-branded character with no logos and no resemblance to existing copyrighted superheroes; preserve any character the user explicitly names. Minimum characters: `1` Maximum characters: `5000`
`imageUrl`	`string`	No	Not specified	Optional input image URL. When provided, the task runs in image edit mode.
`imageUrls`	`string[]`	No	Not specified	Ordered input image URLs for image editing mode. The prompt can reference them by their one-based order. Minimum items: `1` Maximum items: `9`
`width`	`integer`	No	`1024`	Output width in pixels. Minimum: `512` Maximum: `4096` Multiple of: `1`
`height`	`integer`	No	`1024`	Output height in pixels. Minimum: `512` Maximum: `4096` Multiple of: `1`
`thinkingMode`	`boolean`	No	`true`	Enable enhanced reasoning for better prompt understanding and image quality.

text to image

These are public VidMage field names. The server maps them to provider fields. Input media selects the mode; use its limits together with the parameter table.

Control	Mode-specific rule
`prompt`	Required; 1–5000 characters.
`aspectRatio`	Not used in this mode.
`resolution`	Not used in this mode.
`width`	Output width in pixels. Minimum: `512` Maximum: `4096` Multiple of: `1` Default: `1024`
`height`	Output height in pixels. Minimum: `512` Maximum: `4096` Multiple of: `1` Default: `1024`
`thinkingMode`	Enable enhanced reasoning for better prompt understanding and image quality. Default: `true`

image edit

These are public VidMage field names. The server maps them to provider fields. Input media selects the mode; use its limits together with the parameter table.

Control	Mode-specific rule
`prompt`	Required; 1–2048 characters.
`aspectRatio`	Not used in this mode.
`resolution`	Not used in this mode.
`imageUrls`	Up to 9 files. Formats: jpg, jpeg, png, webp.
`width`	Output width in pixels. Minimum: `512` Maximum: `4096` Multiple of: `1` Default: `1024`
`height`	Output height in pixels. Minimum: `512` Maximum: `4096` Multiple of: `1` Default: `1024`

Example request

{
  "prompt": "A whimsical floating library above a sea of clouds, intricate fantasy environment concept art",
  "width": 1024,
  "height": 1024,
  "thinkingMode": true
}

# Set VIDMAGE_IDEMPOTENCY_KEY to a unique value for this task; preserve it for transport retries.
curl -X POST "https://vidmage.ai/api/v1/wan-image-generator/submit" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Idempotency-Key: ${VIDMAGE_IDEMPOTENCY_KEY}" \
  -H "Content-Type: application/json" \
  -d '{"prompt":"A whimsical floating library above a sea of clouds, intricate fantasy environment concept art","width":1024,"height":1024,"thinkingMode":true}'
# -> { "success": true, "taskId": "...", "creditsConsumed": ... }

Task results and recovery

URL of the generated image. Read imageUrl from the completed query response. Preserve taskId while the task is running.

curl -X POST "https://vidmage.ai/api/v1/wan-image-generator/query" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "taskId": "TASK_ID_FROM_SUBMIT" }'
# -> { "success": true, "data": { "status": "...", "imageUrl": "https://..." } }

Submission and task queries report the available task and usage information. A timeout is not a confirmed failure. Recover the existing task instead of resubmitting.

For face selection and error recovery, follow Task lifecycle. MCP uses the normalized taskId argument in get_task_result, including capabilities whose REST identifier is requestId.

Credits

Component / option	Rate	Minimum
Base rate	5 credits / generation	—

Base charge is per generation at the selected resolution.

Use the Playground or the MCP credit estimator for your exact inputs. Credits and billing.

Integration guides

Authentication · File uploads · Task lifecycle · Error recovery · MCP

Wan Image Generator API documentation

Generate images with Wan Image Generator (Alibaba). Supports both text and image input modes.

Endpoints

Contract item	Value
Capability	`wan-image-generator`
Submit	`POST https://vidmage.ai/api/v1/wan-image-generator/submit`
Query	`POST https://vidmage.ai/api/v1/wan-image-generator/query`
Task identifier	`taskId`
Result field	`imageUrl`

Authenticate with Authorization: Bearer YOUR_API_KEY. Save the task identifier and query the same capability. Use a stable Idempotency-Key for submission retries.

Product guide: Wan Image API

Parameters and input rules

Field	Type	Required	Default	Meaning and limits
`prompt`	`string`	Yes	Not specified	Text prompt describing the image to generate (max 5000 chars). For an unspecified character or figurine, use an original non-branded character with no logos and no resemblance to existing copyrighted superheroes; preserve any character the user explicitly names. Minimum characters: `1` Maximum characters: `5000`
`imageUrl`	`string`	No	Not specified	Optional input image URL. When provided, the task runs in image edit mode.
`imageUrls`	`string[]`	No	Not specified	Ordered input image URLs for image editing mode. The prompt can reference them by their one-based order. Minimum items: `1` Maximum items: `9`
`width`	`integer`	No	`1024`	Output width in pixels. Minimum: `512` Maximum: `4096` Multiple of: `1`
`height`	`integer`	No	`1024`	Output height in pixels. Minimum: `512` Maximum: `4096` Multiple of: `1`
`thinkingMode`	`boolean`	No	`true`	Enable enhanced reasoning for better prompt understanding and image quality.

text to image

These are public VidMage field names. The server maps them to provider fields. Input media selects the mode; use its limits together with the parameter table.

Control	Mode-specific rule
`prompt`	Required; 1–5000 characters.
`aspectRatio`	Not used in this mode.
`resolution`	Not used in this mode.
`width`	Output width in pixels. Minimum: `512` Maximum: `4096` Multiple of: `1` Default: `1024`
`height`	Output height in pixels. Minimum: `512` Maximum: `4096` Multiple of: `1` Default: `1024`
`thinkingMode`	Enable enhanced reasoning for better prompt understanding and image quality. Default: `true`

image edit

These are public VidMage field names. The server maps them to provider fields. Input media selects the mode; use its limits together with the parameter table.

Control	Mode-specific rule
`prompt`	Required; 1–2048 characters.
`aspectRatio`	Not used in this mode.
`resolution`	Not used in this mode.
`imageUrls`	Up to 9 files. Formats: jpg, jpeg, png, webp.
`width`	Output width in pixels. Minimum: `512` Maximum: `4096` Multiple of: `1` Default: `1024`
`height`	Output height in pixels. Minimum: `512` Maximum: `4096` Multiple of: `1` Default: `1024`

Example request

{
  "prompt": "A whimsical floating library above a sea of clouds, intricate fantasy environment concept art",
  "width": 1024,
  "height": 1024,
  "thinkingMode": true
}

# Set VIDMAGE_IDEMPOTENCY_KEY to a unique value for this task; preserve it for transport retries.
curl -X POST "https://vidmage.ai/api/v1/wan-image-generator/submit" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Idempotency-Key: ${VIDMAGE_IDEMPOTENCY_KEY}" \
  -H "Content-Type: application/json" \
  -d '{"prompt":"A whimsical floating library above a sea of clouds, intricate fantasy environment concept art","width":1024,"height":1024,"thinkingMode":true}'
# -> { "success": true, "taskId": "...", "creditsConsumed": ... }

Task results and recovery

URL of the generated image. Read imageUrl from the completed query response. Preserve taskId while the task is running.

curl -X POST "https://vidmage.ai/api/v1/wan-image-generator/query" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "taskId": "TASK_ID_FROM_SUBMIT" }'
# -> { "success": true, "data": { "status": "...", "imageUrl": "https://..." } }

Submission and task queries report the available task and usage information. A timeout is not a confirmed failure. Recover the existing task instead of resubmitting.

For face selection and error recovery, follow Task lifecycle. MCP uses the normalized taskId argument in get_task_result, including capabilities whose REST identifier is requestId.

Credits

Component / option	Rate	Minimum
Base rate	5 credits / generation	—

Base charge is per generation at the selected resolution.

Use the Playground or the MCP credit estimator for your exact inputs. Credits and billing.

Integration guides

Authentication · File uploads · Task lifecycle · Error recovery · MCP