Wan 3.0 (Reference)
Wan 3.0 driven by reference materials — images, videos, audio, a document or a web page. Refer to them inside the prompt as 图1 / 视频1 / 音频1 (image 1, video 1, audio 1); the array order is what those numbers refer to.
⚠️ This endpoint rejects first/last frames. The two input modes are mutually exclusive upstream — use wan-3-0 for text-to-video or first/last frame generation.
At least one of ref_imgs / ref_videos / ref_audios / ref_file / ref_link is required. ref_file and ref_link are mutually exclusive.
Pricing — per second of generated video, in tokens (USD at $0.02/token). Both wan-3-0 endpoints cost the same:
| resolution | tokens/s | USD/s |
|---|---|---|
| 480p | 2.91 | $0.0582 |
| 720p | 5.82 | $0.1164 |
| 1080p | 11.64 | $0.2328 |
The published per-second rate times the duration is exactly what gets charged. Example: a 5s 720p video costs 29.1 tokens.
Notes on defaults: resolution defaults to 720p rather than the upstream default of 1080p. Smart duration (-1) is not exposed because the price is only known after generation.
Returns an img_uuid; poll GET /api/v1/jobs/detail (or use custom_callback_url) to get the generated video.
Headers
Body
Model name. Must be wan-3-0-refs.
wan-3-0-refs Text prompt. You can reference each image as [Image 1], [Image 2], etc.
Output aspect ratio. aspect_ratio is accepted as a compatible alias.
adaptive, 16:9, 4:3, 1:1, 3:4, 9:16 Video duration in seconds. Any integer from 2 to 30.
2 <= x <= 30Output resolution, lowercase like every other video model. quality is accepted as a compatible alias.
480p, 720p, 1080p Reference image URLs, up to 10. Referred to as 图1, 图2, … in array order.
10Reference video URLs, up to 5 and 15 seconds in total. Referred to as 视频1, 视频2, … in array order.
5Reference audio URLs, up to 5 and 15 seconds in total. Referred to as 音频1, 音频2, … in array order.
5Optional. A single document URL (docx/pptx/pdf/txt/…). Mutually exclusive with ref_link.
Optional. A single public web page URL. Mutually exclusive with ref_file.
Whether the output contains an audio track. Enabling it costs no extra.
Optional. Fixing the seed makes results more reproducible.
0 <= x <= 2147483647Optional. A publicly accessible HTTPS URL. When the task status changes (processing / success / failed), GoEnhance sends a POST request to this URL. The request body is identical to the response of GET /api/v1/jobs/detail. If your server does not respond with HTTP 200, the notification is retried up to 3 times, with a 3-second timeout per attempt.
"https://your-server.com/goenhance/callback"
