Wan Spicy Video API Documentation

Overview

Animate a still image into a video using the Wan 2.5 / 2.6 open-source video diffusion model family. Part of the Wan series known for fluid motion and temporal consistency.

Primary Endpoint

POST/api/v1/userWanSpicy/start

Start Wan Spicy image-to-video generation

Request Parameters

Name	Type	Required	Description
model	enum: wan2.7-i2v-spicy \| wan2.2-i2v-spicy	No	Model variant (2.7 supports audio, 2.2 no audio)
name	string	No	Optional display name for the task
prompt	string	Yes	Generation prompt
negative_prompt	string	No	Negative prompt (only valid when model = wan2.7-i2v-spicy)
image_url	string	Yes	Reference image URL (https only)
audio_url	string	No	Audio URL (https, .wav/.mp3, only valid when model = wan2.7-i2v-spicy)
resolution	enum: 480p \| 720p \| 1080p	Yes	Resolution tier (wan2.7 720p/1080p, wan2.2 480p/720p)
duration	number	Yes	Output duration in seconds (wan2.7 2-15, wan2.2 5 or 8)
prompt_extend	boolean	No	-
seed	integer	No	Random seed
minor_suspected_skip	boolean	No	Skip pre-charge minor-suspect prompt for the input image
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/userWanSpicy/start" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "wan2.7-i2v-spicy",
  "name": "My generation task",
  "prompt": "A cinematic scene with natural motion",
  "negative_prompt": "A cinematic scene with natural motion",
  "image_url": "https://example.com/reference.jpg",
  "audio_url": "https://example.com/reference.jpg",
  "resolution": "480p",
  "duration": 1,
  "prompt_extend": true,
  "seed": 1,
  "minor_suspected_skip": false,
  "webhook_url": "https://your-server.example.com/a2e/webhook"
}'

Related Endpoints

POST/api/v1/userWan25/start

Start Wan video generation

GET/api/v1/userWan25/allRecords

Get all Wan 2.5 tasks

POST/api/v1/userWan25/batchDetail

Batch query task details

GET/api/v1/userWan25/{_id}

Get Wan 2.5 task details

DELETE/api/v1/userWan25/{_id}

Delete a Wan 2.5 task

POST/api/v1/userWanSpicy/start

Start Wan Spicy image-to-video generation

GET/api/v1/userWanSpicy/allRecords

Get all Wan Spicy tasks

POST/api/v1/userWanSpicy/batchDetail

Batch query task details

GET/api/v1/userWanSpicy/{_id}

Get Wan Spicy task details

DELETE/api/v1/userWanSpicy/{_id}

Delete a Wan Spicy task

POST/api/v1/userWan30/start

Start Wan3.0 all-in-one video generation

Responses

200

Task started successfully

401

Unauthorized - Invalid or missing bearer token