Skip to main content
POST
Wan 3.0 Reference to Video

Headers

Authorization
string

Body

application/json
model
enum<string>
required

Model name. Must be wan-3-0-refs.

Available options:
wan-3-0-refs
prompt
string

Text prompt. You can reference each image as [Image 1], [Image 2], etc.

ratio
enum<string>
default:adaptive

Output aspect ratio. aspect_ratio is accepted as a compatible alias.

Available options:
adaptive,
16:9,
4:3,
1:1,
3:4,
9:16
duration
integer
default:5

Video duration in seconds. Any integer from 2 to 30.

Required range: 2 <= x <= 30
resolution
enum<string>
default:720p

Output resolution, lowercase like every other video model. quality is accepted as a compatible alias.

Available options:
480p,
720p,
1080p
ref_imgs
string<uri>[]

Reference image URLs, up to 10. Referred to as 图1, 图2, … in array order.

Maximum array length: 10
ref_videos
string<uri>[]

Reference video URLs, up to 5 and 15 seconds in total. Referred to as 视频1, 视频2, … in array order.

Maximum array length: 5
ref_audios
string<uri>[]

Reference audio URLs, up to 5 and 15 seconds in total. Referred to as 音频1, 音频2, … in array order.

Maximum array length: 5
ref_file
string<uri>

Optional. 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.

generate_audio
boolean
default:true

Whether the output contains an audio track. Enabling it costs no extra.

seed
integer

Optional. Fixing the seed makes results more reproducible.

Required range: 0 <= x <= 2147483647
custom_callback_url
string<uri>

Optional. 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.

Example:

"https://your-server.com/goenhance/callback"

Response

code
integer
required
msg
string
required
data
object
required