Model API

Wan VACE 14B

VACE is a video generation model that uses a source image, mask, and video to create prompted videos with controllable sources.

Model id

Use this in every request

wan-vace-14b/inpainting

Run it

Quote the input, start the generation with the quote, then poll the job. Set RAYWAKE_API_KEY first; see Authentication.

# 1. Price the exact input (quotes are valid for up to 10 minutes)
curl -s https://api.raywake.com/v1/quotes \
  -H "Authorization: Bearer $RAYWAKE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "wan-vace-14b/inpainting",
  "input": {
    "prompt": "A red ceramic cup on a wooden table, soft morning light",
    "video_url": "https://example.com/input.mp4"
  }
}'

# 2. Start the generation with the quote_id from step 1
curl -s https://api.raywake.com/v1/generate \
  -H "Authorization: Bearer $RAYWAKE_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{"model": "wan-vace-14b/inpainting", "quote_id": "QUOTE_ID", "input": {"prompt":"A red ceramic cup on a wooden table, soft morning light","video_url":"https://example.com/input.mp4"}}'

# 3. Poll until the status is terminal
curl -s https://api.raywake.com/v1/jobs/JOB_ID \
  -H "Authorization: Bearer $RAYWAKE_API_KEY"

Input

Input fields for wan-vace-14b/inpainting
Name	Type	Description
`prompt`required	string	The text prompt to guide video generation.
`negative_prompt`	string	Negative prompt for video generation. Default: `letterboxing, borders, black bars, bright colors, overexposed, static, blurred details, subtitles, style, artwork, painting, picture, still, overall gray, worst quality, low quality, JPEG compression residue, ugly, incomplete, extra fingers, poorly drawn hands, poorly drawn faces, deformed, disfigured, malformed limbs, fused fingers, still picture, cluttered background, three legs, many people in the background, walking backwards`
`match_input_num_frames`	boolean	If true, the number of frames in the generated video will match the number of frames in the input video. If false, the number of frames will be determined by the num_frames parameter. Default: `false`
`num_frames`	integer	Number of frames to generate. Must be between 81 to 241 (inclusive). Default: `81`
`match_input_frames_per_second`	boolean	If true, the frames per second of the generated video will match the input video. If false, the frames per second will be determined by the frames_per_second parameter. Default: `false`
`frames_per_second`	integer	Frames per second of the generated video. Must be between 5 to 30. Ignored if match_input_frames_per_second is true. Default: `16`
`seed`	integer	Random seed for reproducibility. If None, a random seed is chosen.
`resolution`	string (enum)	Resolution of the generated video. Default: `480p` One of: `480p`, `580p`, `720p`
`aspect_ratio`	string (enum)	Aspect ratio of the generated video. Default: `auto` One of: `auto`, `16:9`, `1:1`, `9:16`
`num_inference_steps`	integer	Number of inference steps for sampling. Higher values give better quality but take longer. Default: `30`
`guidance_scale`	number	Guidance scale for classifier-free guidance. Higher values encourage the model to generate images closely related to the text prompt. Default: `5`
`sampler`	string (enum)	Sampler to use for video generation. Default: `unipc` One of: `unipc`, `dpm++`, `euler`
`shift`	number	Shift parameter for video generation. Default: `5`
`video_url`required	string (URL)	URL to the source video file. Required for inpainting.
`mask_video_url`	string (URL)	URL to the source mask file. Required for inpainting.
`mask_image_url`	string (image URL)	URL to the guiding mask file. If provided, the model will use this mask as a reference to create masked video using salient mask tracking. Will be ignored if mask_video_url is provided.
`ref_image_urls`	array of image URLs	Urls to source reference image. If provided, the model will use this image as reference.
`first_frame_url`	string (image URL)	URL to the first frame of the video. If provided, the model will use this frame as a reference.
`last_frame_url`	string (image URL)	URL to the last frame of the video. If provided, the model will use this frame as a reference.
`enable_prompt_expansion`	boolean	Whether to enable prompt expansion. Default: `false`
`preprocess`	boolean	Whether to preprocess the input video. Default: `false`
`acceleration`	string (enum)	Acceleration to use for inference. Options are 'none' or 'regular'. Accelerated inference will very slightly affect output, but will be significantly faster. Default: `regular` One of: `none`, `low`, `regular`
`video_quality`	string (enum)	The quality of the generated video. Default: `high` One of: `low`, `medium`, `high`, `maximum`
`video_write_mode`	string (enum)	The write mode of the generated video. Default: `balanced` One of: `fast`, `balanced`, `small`
`num_interpolated_frames`	integer	Number of frames to interpolate between the original frames. A value of 0 means no interpolation. Default: `0`
`temporal_downsample_factor`	integer	Temporal downsample factor for the video. This is an integer value that determines how many frames to skip in the video. A value of 0 means no downsampling. For each downsample factor, one upsample factor will automatically be applied. Default: `0`
`enable_auto_downsample`	boolean	If true, the model will automatically temporally downsample the video to an appropriate frame length for the model, then will interpolate it back to the original frame length. Default: `false`
`auto_downsample_min_fps`	number	The minimum frames per second to downsample the video to. This is used to help determine the auto downsample factor to try and find the lowest detail-preserving downsample factor. The default value is appropriate for most videos, if you are using a video with very fast motion, you may need to increase this value. If your video has a very low amount of motion, you could decrease this value to allow for higher downsampling and thus longer sequences. Default: `15`
`interpolator_model`	string (enum)	The model to use for frame interpolation. Options are 'rife' or 'film'. Default: `film` One of: `rife`, `film`
`sync_mode`	boolean	If `True`, the media will be returned as a data URI and the output data won't be available in the request history. Default: `false`
`transparency_mode`	string (enum)	The transparency mode to apply to the first and last frames. This controls how the transparent areas of the first and last frames are filled. Default: `content_aware` One of: `content_aware`, `white`, `black`
`return_frames_zip`	boolean	If true, also return a ZIP file containing all generated frames. Default: `false`

Output

A succeeded job lists its results under outputs, stored on our side. See Jobs for every field.

Job excerpt

"outputs": [
  { "type": "video", "url": "https://…", "mime_type": "video/mp4", "thumbnail_url": "https://…" }
]

Pricing

per second$0.1268/ second

The exact charge for your input comes from a quote. How charges settle