Reference to Video API Documentation

Overview

Generate a video from reference images with the fast Wan 2.6 reference-to-video workflow.

Primary Endpoint

POST/api/v1/userWan26R2V/start

Start reference-to-video generation

Request Parameters

Name	Type	Required	Description
model	enum: wan2.6-r2v-flash \| wan2.6-r2v	No	Model variant (flash=faster+cheaper, standard=higher quality audio-only)
name	string	No	Task name
reference_urls	array<string>	Yes	Array of reference image/video URLs (max 5)
prompt	string	Yes	Generation prompt (use character1, character2 to reference inputs)
duration	enum: 5 \| 10	No	-
resolution	enum: 720p \| 1080p	No	Resolution tier, combined with aspect_ratio to determine actual size
aspect_ratio	enum: 16:9 \| 9:16 \| 1:1 \| 4:3 \| 3:4	No	Aspect ratio for the output video
shot_type	enum: single \| multi	No	-
audio	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/userWan26R2V/start" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "wan2.6-r2v-flash",
  "name": "My generation task",
  "reference_urls": "https://example.com/reference.jpg",
  "prompt": "A cinematic scene with natural motion",
  "duration": "5",
  "resolution": "720p",
  "aspect_ratio": "16:9",
  "shot_type": "single",
  "audio": true,
  "webhook_url": "https://your-server.example.com/a2e/webhook",
  "webhook_token": "a-shared-secret"
}'

Related Endpoints

POST/api/v1/userWan26R2V/start

Start reference-to-video generation

GET/api/v1/userWan26R2V/allRecords

Get all R2V tasks

POST/api/v1/userWan26R2V/batchDetail

Batch query task details

GET/api/v1/userWan26R2V/{_id}

Get R2V task details

DELETE/api/v1/userWan26R2V/{_id}

Delete a R2V task

Responses

200

Task started successfully

401

Unauthorized - Invalid or missing bearer token