Wan 2.7 Image API Documentation

Overview

Generate images with the Wan 2.7 image model using text prompts and configurable output dimensions.

Primary Endpoint

POST/api/v1/userWan27Image/start

Start a new Wan2.7-Image generation task

Request Parameters

Name	Type	Required	Description
name	string	Yes	-
prompt	string	Yes	Text prompt (max 5000 chars)
model	enum: wan2.7-image \| wan2.7-image-pro	No	-
input_images	array<string>	No	Input images for editing (0-9 images, max 20MB each)
aspect_ratio	enum: 1:1 \| 3:2 \| 2:3 \| 4:3 \| 3:4 \| 16:9 \| 9:16 \| 21:9	No	-
bbox_list	array<object>	No	Bounding boxes for interactive editing
force_generate	boolean	No	-
webhook_url	string	No	HTTPS URL to receive task.completed / task.failed notifications. Best-effort delivery, single attempt, no retries; clients should treat the detail API as the source of truth.
webhook_token	string	No	Optional plaintext token returned in the X-A2e-Webhook-Token header so receivers can verify the request originated from a2e.

Request Example

curl -X POST "https://www.a2e.com.cn/api/v1/userWan27Image/start" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "name": "My generation task",
  "prompt": "A cinematic scene with natural motion",
  "model": "wan2.7-image",
  "input_images": [],
  "aspect_ratio": "1:1",
  "bbox_list": [],
  "force_generate": false,
  "webhook_url": "https://your-server.example.com/a2e/webhook",
  "webhook_token": "a-shared-secret"
}'

Related Endpoints

POST/api/v1/userWan27Image/start

Start a new Wan2.7-Image generation task

GET/api/v1/userWan27Image/list

Get task list

GET/api/v1/userWan27Image/detail/{id}

Get task details

POST/api/v1/userWan27Image/batchDetail

Batch query task details

DELETE/api/v1/userWan27Image/{id}

Delete task

Responses

200

Task started successfully or NSFW content detected

401

Unauthorized - Invalid or missing bearer token