—
Alibaba Wan — Outpainting
VACE is a video generation model that uses a source image, mask, and video to create prompted videos with controllable sources.
Input
Add your inputs and customize the generation settings.
Result & Pricing
Video output — your generated video will appear here.
Your video will appear here
Choose your inputs and customize your settings.
Model pricing (tax excluded) per video second at the documented billing FPS
| Specification | Webot INR |
|---|---|
| 480p | ₹4.79 |
| 580p | ₹7.19 |
| 720p | ₹9.58 |
Calculate credits in the input panel for your selected settings.
Prices, estimates and credit deductions exclude tax. Any applicable tax is charged only when you buy plans or credits.
Billed video seconds = frames ÷ 16. Prices are converted to INR. Credits use your current plan rate.
- Prices shown are estimates, not final charges. Final billing details will be available in Reports after generation is complete.
API
WEBOT API · Outpainting
Generate from your server with your WEBOT account credits.
Use your 120-character WEBOT customer key (a–z, A–Z, 0–9). Send
Authorization: Bearer YOUR_KEY. Keys are secrets: call from a server, never from public frontend code. Results come from verified webhooks and remain saved if your stream disconnects.1. Configure your server
WEBOT_BASE_URL=https://webot.online
WEBOT_API_KEY=<your-server-side-WEBOT-key>This base URL is resolved from verified domain mappings and your direct creator reseller. Forwarded Host headers are not trusted. New custom reseller domains need DNS, TLS and platform verification before activation.
2. Quote, then generate
| Method | Endpoint | Purpose |
|---|---|---|
| POST | https://webot.online/api/v1/models/alibaba_wan_vace_14b_outpainting/quote | Validate input and calculate credits (no deduction). |
| POST | https://webot.online/api/v1/models/alibaba_wan_vace_14b_outpainting/requests | Reserve quoted credits and queue an asynchronous job. |
| GET | https://webot.online/api/v1/models/alibaba_wan_vace_14b_outpainting/requests/{request_id}/result | Read your saved result: 202 pending, 200 terminal. |
| GET | https://webot.online/api/v1/models/alibaba_wan_vace_14b_outpainting/requests/{request_id}/events | Authenticated SSE: generation / terminal events. |
Send JSON {"input":{…}} to quote. Send the same input plus integer quoted_credits to generate, with Authorization: Bearer … and Idempotency-Key. Use a unique 16–128 character key per new job; persist it and reuse the same key and input on any uncertain response. Never retry with a new key: that creates a second chargeable job.
Credits are reserved only after validation and a durable request is saved. A changed quote or insufficient balance returns 409. Credits exclude purchase taxes. The quoted amount is an initial reservation. After generation, the final charge replaces it using confirmed usage. Any verified unused allocation becomes available automatically; additional usage may require more credits. Missing billing stays pending, including for failed jobs.
3. Input example
Save this as input.json. Replace sample prompts, files and media URLs with your own. Schemas do not guarantee provider acceptance of the content.
Supported generation options
- Disable automatic and temporal downsampling for verified frame billing.
{
"prompt": "Audit sample text",
"video_url": "https://example.com/video.mp4",
"resolution": "480p",
"sampler": "unipc",
"negative_prompt": "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",
"guidance_scale": 5,
"enable_prompt_expansion": false,
"num_frames": 81,
"aspect_ratio": "auto",
"enable_safety_checker": false,
"num_interpolated_frames": 0,
"enable_auto_downsample": false,
"shift": 5,
"video_quality": "high",
"sync_mode": false,
"match_input_num_frames": false,
"auto_downsample_min_fps": 15,
"acceleration": "regular",
"match_input_frames_per_second": false,
"num_inference_steps": 30,
"return_frames_zip": false,
"interpolator_model": "film",
"video_write_mode": "balanced",
"temporal_downsample_factor": 0,
"expand_right": false,
"expand_top": false,
"expand_bottom": false,
"expand_left": false,
"expand_ratio": 0.25,
"transparency_mode": "content_aware",
"frames_per_second": 16
}4. Language examples
# Save the model's example input as input.json, then replace prompts/media URLs.
# Requires curl and jq. Store NONCE once for this job; reuse it on any retry.
export NONCE="$(openssl rand -hex 16)"
BASE="${WEBOT_BASE_URL%/}"
jq -n --slurpfile input input.json '{input:$input[0]}' > quote-body.json
curl --fail-with-body -sS "$BASE/api/v1/models/alibaba_wan_vace_14b_outpainting/quote" \
-H "Authorization: Bearer $WEBOT_API_KEY" -H 'Content-Type: application/json' \
--data-binary @quote-body.json > quote.json
CREDITS=$(jq -er '.quote.credits_consumed' quote.json)
jq --argjson credits "$CREDITS" '. + {quoted_credits:$credits}' quote-body.json > request-body.json
curl --fail-with-body -sS "$BASE/api/v1/models/alibaba_wan_vace_14b_outpainting/requests" \
-H "Authorization: Bearer $WEBOT_API_KEY" -H "Idempotency-Key: $NONCE" \
-H 'Content-Type: application/json' --data-binary @request-body.json > job.json
# Subscribe; after a nonterminal disconnect, reconnect this SAME URL.
curl --fail-with-body -N "$(jq -er '.events_url' job.json)" -H "Authorization: Bearer $WEBOT_API_KEY"
# Read saved output after terminal notification (never call provider status/results).
curl --fail-with-body -sS "$(jq -er '.result_url' job.json)" -H "Authorization: Bearer $WEBOT_API_KEY"// Node.js 18+. Save your customized input in input.json.
import { readFileSync } from 'node:fs';
import { randomUUID } from 'node:crypto';
const base = process.env.WEBOT_BASE_URL.replace(/\/$/, '');
const key = process.env.WEBOT_API_KEY;
const input = JSON.parse(readFileSync('input.json', 'utf8'));
const nonce = process.env.WEBOT_JOB_NONCE || randomUUID(); // Persist before submission.
async function post(path, body, nonce) {
const response = await fetch(base + path, {method:'POST', headers:{
Authorization:`Bearer ${key}`, 'Content-Type':'application/json',
...(nonce ? {'Idempotency-Key':nonce} : {})}, body:JSON.stringify(body)});
const json = await response.json();
if (!response.ok) throw new Error(JSON.stringify(json));
return json;
}
const {quote} = await post('/api/v1/models/alibaba_wan_vace_14b_outpainting/quote', {input});
const job = await post('/api/v1/models/alibaba_wan_vace_14b_outpainting/requests', {input, quoted_credits:quote.credits_consumed}, nonce);
console.log(job); // Stable WEBOT request_id, events_url, result_url.
// Stream saved webhook state. Reconnect ONLY the event stream, not the generation.
while (!job.terminal || job.financial_pending) {
const stream = await fetch(job.events_url, {headers:{Authorization:`Bearer ${key}`}});
if (!stream.ok) throw new Error(`Event stream HTTP ${stream.status}`);
let buffer = '';
for await (const chunk of stream.body.pipeThrough(new TextDecoderStream())) {
buffer += chunk;
let end;
while ((end = buffer.indexOf('\n\n')) !== -1) {
const event = buffer.slice(0, end); buffer = buffer.slice(end + 2);
const data = event.split('\n').find(line => line.startsWith('data: '));
if (!data) continue;
const state = JSON.parse(data.slice(6));
if (state.error && !state.status) throw new Error(JSON.stringify(state.error));
if (state.terminal && !state.financial_pending) { console.log(state.output ?? state.error); process.exit(0); }
}
}
await new Promise(resolve => setTimeout(resolve, 1500));
}
console.log(job.output ?? job.error);// Node.js 18+. Save your customized input in input.json.
import { readFileSync } from 'node:fs';
import { randomUUID } from 'node:crypto';
const base = process.env.WEBOT_BASE_URL!.replace(/\/$/, '');
const key = process.env.WEBOT_API_KEY!;
const input = JSON.parse(readFileSync('input.json', 'utf8'));
const nonce = process.env.WEBOT_JOB_NONCE || randomUUID(); // Persist before submission.
async function post(path: string, body: unknown, nonce?: string) {
const response = await fetch(base + path, {method:'POST', headers:{
Authorization:`Bearer ${key}`, 'Content-Type':'application/json',
...(nonce ? {'Idempotency-Key':nonce} : {})}, body:JSON.stringify(body)});
const json = await response.json();
if (!response.ok) throw new Error(JSON.stringify(json));
return json;
}
const {quote} = await post('/api/v1/models/alibaba_wan_vace_14b_outpainting/quote', {input});
const job = await post('/api/v1/models/alibaba_wan_vace_14b_outpainting/requests', {input, quoted_credits:quote.credits_consumed}, nonce);
console.log(job); // Stable WEBOT request_id, events_url, result_url.
// Stream saved webhook state. Reconnect ONLY the event stream, not the generation.
while (!job.terminal || job.financial_pending) {
const stream = await fetch(job.events_url, {headers:{Authorization:`Bearer ${key}`}});
if (!stream.ok) throw new Error(`Event stream HTTP ${stream.status}`);
let buffer = '';
for await (const chunk of stream.body.pipeThrough(new TextDecoderStream())) {
buffer += chunk;
let end;
while ((end = buffer.indexOf('\n\n')) !== -1) {
const event = buffer.slice(0, end); buffer = buffer.slice(end + 2);
const data = event.split('\n').find(line => line.startsWith('data: '));
if (!data) continue;
const state = JSON.parse(data.slice(6));
if (state.error && !state.status) throw new Error(JSON.stringify(state.error));
if (state.terminal && !state.financial_pending) { console.log(state.output ?? state.error); process.exit(0); }
}
}
await new Promise(resolve => setTimeout(resolve, 1500));
}
console.log(job.output ?? job.error);# Python 3.9+, pip install requests
import json, os, time, uuid, requests
base = os.environ['WEBOT_BASE_URL'].rstrip('/')
headers = {'Authorization': 'Bearer ' + os.environ['WEBOT_API_KEY']}
with open('input.json', encoding='utf-8') as file:
input_data = json.load(file)
nonce = os.environ.get('WEBOT_JOB_NONCE') or str(uuid.uuid4()) # Persist before submitting.
def post(path, body, extra=None):
response = requests.post(base + path, headers={**headers, **(extra or {})}, json=body, timeout=180)
response.raise_for_status()
return response.json()
quote = post('/api/v1/models/alibaba_wan_vace_14b_outpainting/quote', {'input': input_data})['quote']
job = post('/api/v1/models/alibaba_wan_vace_14b_outpainting/requests', {'input': input_data, 'quoted_credits': quote['credits_consumed']}, {'Idempotency-Key': nonce})
state = job
while not state['terminal'] or state.get('financial_pending', False):
# Reconnect while nonterminal; this reads WEBOT's database, never a provider status API.
with requests.get(job['events_url'], headers=headers, stream=True, timeout=(10, 40)) as stream:
stream.raise_for_status()
for line in stream.iter_lines(decode_unicode=True):
if line and line.startswith('data: '):
state = json.loads(line[6:])
if 'status' not in state: raise RuntimeError(state)
if state['terminal'] and not state.get('financial_pending', False): break
if not state['terminal'] or state.get('financial_pending', False): time.sleep(1.5)
print(state['output'] if state['status'] == 'completed' else state['error'])<?php // PHP 8.1+ with cURL
$base = rtrim(getenv('WEBOT_BASE_URL'), '/');
$input = json_decode(file_get_contents('input.json'), false, 64, JSON_THROW_ON_ERROR);
$nonce = getenv('WEBOT_JOB_NONCE') ?: bin2hex(random_bytes(16)); // Persist this before submission.
function post(string $path, array $body, ?string $nonce = null): array {
global $base;
$headers = ['Authorization: Bearer '.getenv('WEBOT_API_KEY'), 'Content-Type: application/json'];
if ($nonce) $headers[] = 'Idempotency-Key: '.$nonce;
$ch = curl_init($base.$path);
curl_setopt_array($ch, [CURLOPT_RETURNTRANSFER=>true, CURLOPT_POST=>true,
CURLOPT_TIMEOUT=>180, CURLOPT_HTTPHEADER=>$headers,
CURLOPT_POSTFIELDS=>json_encode($body, JSON_THROW_ON_ERROR)]);
$raw = curl_exec($ch); $status = curl_getinfo($ch, CURLINFO_HTTP_CODE); curl_close($ch);
if ($raw === false || $status < 200 || $status >= 300) throw new RuntimeException('WEBOT HTTP '.$status);
return json_decode($raw, true, 64, JSON_THROW_ON_ERROR);
}
$quote = post('/api/v1/models/alibaba_wan_vace_14b_outpainting/quote', ['input'=>$input])['quote'];
$job = post('/api/v1/models/alibaba_wan_vace_14b_outpainting/requests', ['input'=>$input, 'quoted_credits'=>$quote['credits_consumed']], $nonce);
echo json_encode($job, JSON_PRETTY_PRINT); // Connect to events_url with the same Bearer header.// Go 1.20+; save as main.go.
package main
import ("bytes"; "encoding/json"; "fmt"; "io"; "net/http"; "os"; "strings"; "time"; "crypto/rand"; "encoding/hex")
func main() {
base := strings.TrimRight(os.Getenv("WEBOT_BASE_URL"), "/")
raw, err := os.ReadFile("input.json"); if err != nil { panic(err) }
nonce := os.Getenv("WEBOT_JOB_NONCE")
if nonce == "" { b := make([]byte,16); if _,err:=rand.Read(b);err!=nil {panic(err)}; nonce=hex.EncodeToString(b) }
// Persist nonce before the submission; reuse on ambiguous responses.
client := &http.Client{Timeout:180*time.Second}
post := func(path string, body any, id string) map[string]any {
data, err := json.Marshal(body); if err != nil {panic(err)}
req, err := http.NewRequest("POST",base+path,bytes.NewReader(data)); if err!=nil {panic(err)}
req.Header.Set("Authorization","Bearer "+os.Getenv("WEBOT_API_KEY")); req.Header.Set("Content-Type","application/json")
if id!="" {req.Header.Set("Idempotency-Key",id)}
res,err:=client.Do(req); if err!=nil {panic(err)}; defer res.Body.Close()
data,err=io.ReadAll(res.Body); if err!=nil {panic(err)}
if res.StatusCode<200||res.StatusCode>=300 {panic(string(data))}
var result map[string]any; if err=json.Unmarshal(data,&result);err!=nil {panic(err)}; return result
}
input:=json.RawMessage(raw)
quote:=post("/api/v1/models/alibaba_wan_vace_14b_outpainting/quote",map[string]any{"input":input},"")["quote"].(map[string]any)
job:=post("/api/v1/models/alibaba_wan_vace_14b_outpainting/requests",map[string]any{"input":input,"quoted_credits":quote["credits_consumed"]},nonce)
fmt.Println(job) // Stream events_url with the same Authorization header.
}// Java 11+, Jackson databind dependency; class Main in Main.java.
import java.net.URI;
import java.net.http.*;
import java.nio.file.*;
import java.time.Duration;
import java.util.UUID;
import com.fasterxml.jackson.databind.*;
import com.fasterxml.jackson.databind.node.ObjectNode;
public class Main {
static final ObjectMapper json = new ObjectMapper();
static final HttpClient client = HttpClient.newHttpClient();
static final String base = System.getenv("WEBOT_BASE_URL").replaceAll("/$", "");
static JsonNode post(String path, JsonNode body, String nonce) throws Exception {
var b = HttpRequest.newBuilder(URI.create(base+path)).timeout(Duration.ofSeconds(180))
.header("Authorization","Bearer "+System.getenv("WEBOT_API_KEY")).header("Content-Type","application/json")
.POST(HttpRequest.BodyPublishers.ofString(json.writeValueAsString(body)));
if(nonce!=null)b.header("Idempotency-Key",nonce);
var r=client.send(b.build(),HttpResponse.BodyHandlers.ofString());
if(r.statusCode()<200||r.statusCode()>=300)throw new IllegalStateException(r.body());
return json.readTree(r.body());
}
public static void main(String[] args) throws Exception {
var input=json.readTree(Files.readString(Path.of("input.json")));
ObjectNode body=json.createObjectNode();body.set("input",input);
var quote=post("/api/v1/models/alibaba_wan_vace_14b_outpainting/quote",body,null).get("quote");
body.put("quoted_credits",quote.get("credits_consumed").asInt());
String nonce=System.getenv("WEBOT_JOB_NONCE");if(nonce==null)nonce=UUID.randomUUID().toString(); // Persist before POST.
var job=post("/api/v1/models/alibaba_wan_vace_14b_outpainting/requests",body,nonce);System.out.println(job);
// Subscribe to job.events_url with Authorization; use BodyHandlers.ofLines().
}
}// .NET 8 console app, top-level statements.
using System.Net.Http;
using System.Text;
using System.Text.Json.Nodes;
var client = new HttpClient { Timeout = TimeSpan.FromSeconds(180) };
var root = Environment.GetEnvironmentVariable("WEBOT_BASE_URL")!.TrimEnd('/');
var key = Environment.GetEnvironmentVariable("WEBOT_API_KEY");
async Task<JsonNode> Post(string path, JsonNode body, string? nonce = null) {
using var req = new HttpRequestMessage(HttpMethod.Post, root + path);
req.Headers.Add("Authorization", "Bearer " + key);
if (nonce != null) req.Headers.Add("Idempotency-Key", nonce);
req.Content = new StringContent(body.ToJsonString(), Encoding.UTF8, "application/json");
using var res = await client.SendAsync(req);
var raw = await res.Content.ReadAsStringAsync();res.EnsureSuccessStatusCode();
return JsonNode.Parse(raw)!;
}
var input = JsonNode.Parse(await File.ReadAllTextAsync("input.json"));
var body = new JsonObject { ["input"] = input };
var quote = await Post("/api/v1/models/alibaba_wan_vace_14b_outpainting/quote", body);
body["quoted_credits"] = quote["quote"]!["credits_consumed"]!.GetValue<int>();
var nonce = Environment.GetEnvironmentVariable("WEBOT_JOB_NONCE") ?? Guid.NewGuid().ToString(); // Persist before submitting.
var job = await Post("/api/v1/models/alibaba_wan_vace_14b_outpainting/requests", body, nonce);
Console.WriteLine(job); // Subscribe to events_url with the same Bearer header and ResponseHeadersRead.# Ruby 3+, standard library only.
require 'net/http'
require 'json'
require 'securerandom'
base = ENV.fetch('WEBOT_BASE_URL').sub(%r{/$}, '')
post = lambda do |path, body, nonce = nil|
uri = URI(base + path)
req = Net::HTTP::Post.new(uri)
req['Authorization'] = 'Bearer ' + ENV.fetch('WEBOT_API_KEY')
req['Content-Type'] = 'application/json'
req['Idempotency-Key'] = nonce if nonce
req.body = JSON.generate(body)
res = Net::HTTP.start(uri.host, uri.port, use_ssl: true, read_timeout: 180) { |http| http.request(req) }
raise res.body unless res.is_a?(Net::HTTPSuccess)
JSON.parse(res.body)
end
input = JSON.parse(File.read('input.json'))
quote = post.call('/api/v1/models/alibaba_wan_vace_14b_outpainting/quote', {'input' => input})['quote']
nonce = ENV['WEBOT_JOB_NONCE'] || SecureRandom.uuid # Persist this before submission.
job = post.call('/api/v1/models/alibaba_wan_vace_14b_outpainting/requests', {'input' => input, 'quoted_credits' => quote['credits_consumed']}, nonce)
puts JSON.pretty_generate(job) # Subscribe to events_url with the same Authorization header.// Swift 5.9 server-side/CLI only. Do not embed customer keys in shipped apps.
import Foundation
#if canImport(FoundationNetworking)
import FoundationNetworking
#endif
@main struct Main {
static func main() async throws {
let env=ProcessInfo.processInfo.environment
let base=env["WEBOT_BASE_URL"]!.trimmingCharacters(in: CharacterSet(charactersIn:"/"))
let input=try JSONSerialization.jsonObject(with: Data(contentsOf:URL(fileURLWithPath:"input.json")))
func post(_ path:String,_ body:[String:Any],_ nonce:String?=nil) async throws -> [String:Any] {
var req=URLRequest(url:URL(string:base+path)!);req.httpMethod="POST";req.timeoutInterval=180
req.setValue("Bearer "+env["WEBOT_API_KEY"]!,forHTTPHeaderField:"Authorization")
req.setValue("application/json",forHTTPHeaderField:"Content-Type")
if let nonce {req.setValue(nonce,forHTTPHeaderField:"Idempotency-Key")}
req.httpBody=try JSONSerialization.data(withJSONObject:body)
let (data,res)=try await URLSession.shared.data(for:req)
guard let http=res as? HTTPURLResponse,(200..<300).contains(http.statusCode) else {throw NSError(domain:"WEBOT",code:1)}
return try JSONSerialization.jsonObject(with:data) as! [String:Any]
}
let quote=try await post("/api/v1/models/alibaba_wan_vace_14b_outpainting/quote",["input":input])["quote"] as! [String:Any]
let nonce=env["WEBOT_JOB_NONCE"] ?? UUID().uuidString // Persist before submission.
let job=try await post("/api/v1/models/alibaba_wan_vace_14b_outpainting/requests",["input":input,"quoted_credits":quote["credits_consumed"]!],nonce)
print(job) // Subscribe to events_url with the same Authorization header.
}
}// Server-side Kotlin/JVM 17+, Gradle dependencies: OkHttp 4.12, org.json 20240303.
import okhttp3.*
import okhttp3.MediaType.Companion.toMediaType
import okhttp3.RequestBody.Companion.toRequestBody
import org.json.JSONObject
import java.io.File
import java.util.UUID
import java.util.concurrent.TimeUnit
fun main() {
val base=System.getenv("WEBOT_BASE_URL").trimEnd('/')
val client=OkHttpClient.Builder().readTimeout(180,TimeUnit.SECONDS).build()
fun post(path:String,body:JSONObject,nonce:String?=null):JSONObject {
val b=Request.Builder().url(base+path).header("Authorization","Bearer "+System.getenv("WEBOT_API_KEY"))
.post(body.toString().toRequestBody("application/json".toMediaType()))
if(nonce!=null)b.header("Idempotency-Key",nonce)
return client.newCall(b.build()).execute().use {res ->
val raw=res.body!!.string();check(res.isSuccessful){raw};JSONObject(raw)
}
}
val body=JSONObject().put("input",JSONObject(File("input.json").readText()))
val quote=post("/api/v1/models/alibaba_wan_vace_14b_outpainting/quote",body).getJSONObject("quote")
body.put("quoted_credits",quote.getInt("credits_consumed"))
val nonce=System.getenv("WEBOT_JOB_NONCE") ?: UUID.randomUUID().toString() // Persist before submission.
val job=post("/api/v1/models/alibaba_wan_vace_14b_outpainting/requests",body,nonce)
println(job) // Subscribe to events_url with the same Authorization header.
}5. Receive all results
The response includes a stable WEBOT request_id, events_url and result_url. Subscribe with a Bearer-authenticated HTTP stream. Nonterminal streams end after 25 seconds; reconnect to the same URL after at least 1.5 seconds. Current saved state is replayed immediately, including completion that happened while disconnected. A terminal event contains the result envelope. The JSON terminal flag describes generation completion. Keep reconnecting while financial_pending is true; stop after the terminal event confirms financial settlement. Never poll provider status/results. Native browser EventSource cannot send a Bearer header; keep the key on your server.
Completed output contains the full model result, including every generated media/document item, not just the first URL. Failed output is null with error and refund_state. Results are strictly limited to the key owner, including on reseller domains. Model-independent aliases: /api/v1/requests/{request_id}/result and /events. Revoking a key blocks subsequent reads and streams; saved results remain accessible with another valid key of the same account.
6. Schemas and parameter defaults
Required fields are marked with *. Required text must contain non-whitespace content. Defaults apply when an optional parameter is omitted; null, false, 0 and an empty array are distinct values. “No documented default” means WEBOT does not invent one. Examples are sample inputs, not defaults. WEBOT generation constraints can require an explicit value even when the provider publishes an automatic default.
Input schema · fields, constraints and defaults
| Parameter | Type | Required | Default when omitted | Description / constraints |
|---|---|---|---|---|
sampler | string | No | "unipc" | Sampler to use for video generation. enum: ["unipc","dpm++","euler"] |
negative_prompt | string | No | "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" | Negative prompt for video generation. |
guidance_scale | number | No | 5 | Guidance scale for classifier-free guidance. Higher values encourage the model to generate images closely related to the text prompt. minimum: 1 · maximum: 10 |
enable_prompt_expansion | boolean | No | false | Whether to enable prompt expansion. |
num_frames | integer | No | 81 | Number of frames to generate. Must be between 81 to 241 (inclusive). minimum: 17 · maximum: 241 |
aspect_ratio | string | No | "auto" | Aspect ratio of the generated video. enum: ["auto","16:9","1:1","9:16"] |
ref_image_urls | array | No | No documented default | URLs to source reference image. If provided, the model will use this image as reference. |
enable_safety_checker | boolean | No | false | If set to true, the safety checker will be enabled. Disabling it requires account authorization; unauthorized requests are always checked. |
num_interpolated_frames | integer | No | 0 | Number of frames to interpolate between the original frames. A value of 0 means no interpolation. minimum: 0 · maximum: 5 |
enable_auto_downsample | boolean | No | false | 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. |
shift | number | No | 5 | Shift parameter for video generation. minimum: 1 · maximum: 15 |
prompt | string | Yes * | No documented default | The text prompt to guide video generation. |
video_quality | string | No | "high" | The quality of the generated video. enum: ["low","medium","high","maximum"] |
sync_mode | boolean | No | false | If `True`, the media will be returned as a data URI and the output data won't be available in the request history. |
video_url | string | Yes * | No documented default | URL to the source video file. Required for outpainting. |
match_input_num_frames | boolean | No | false | 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. |
last_frame_url | string | null | No | No documented default | URL to the last frame of the video. If provided, the model will use this frame as a reference. |
auto_downsample_min_fps | number | No | 15 | 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. minimum: 1 · maximum: 60 |
acceleration | string | null | No | "regular" | Acceleration to use for inference. Options are 'none' or 'regular'. Accelerated inference will very slightly affect output, but will be significantly faster. |
match_input_frames_per_second | boolean | No | false | 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. |
num_inference_steps | integer | No | 30 | Number of inference steps for sampling. Higher values give better quality but take longer. minimum: 2 · maximum: 50 |
return_frames_zip | boolean | No | false | If true, also return a ZIP file containing all generated frames. |
first_frame_url | string | null | No | No documented default | URL to the first frame of the video. If provided, the model will use this frame as a reference. |
interpolator_model | string | No | "film" | The model to use for frame interpolation. Options are 'rife' or 'film'. enum: ["rife","film"] |
video_write_mode | string | No | "balanced" | The write mode of the generated video. enum: ["fast","balanced","small"] |
temporal_downsample_factor | integer | No | 0 | 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. minimum: 0 · maximum: 5 |
expand_right | boolean | No | false | Whether to expand the video to the right. |
expand_top | boolean | No | false | Whether to expand the video to the top. |
expand_bottom | boolean | No | false | Whether to expand the video to the bottom. |
expand_left | boolean | No | false | Whether to expand the video to the left. |
expand_ratio | number | No | 0.25 | Amount of expansion. This is a float value between 0 and 1, where 0.25 adds 25% to the original video size on the specified sides. minimum: 0 · maximum: 1 |
resolution | string | No | "720p" | Resolution of the generated video. enum: ["480p","580p","720p"] |
transparency_mode | string | No | "content_aware" | 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. enum: ["content_aware","white","black"] |
seed | integer | null | No | No documented default | Random seed for reproducibility. If None, a random seed is chosen. |
frames_per_second | integer | null | No | 16 | Frames per second of the generated video. Must be between 5 to 30. Ignored if match_input_frames_per_second is true. |
{
"type": "object",
"properties": {
"sampler": {
"default": "unipc",
"examples": [
"unipc"
],
"type": "string",
"description": "Sampler to use for video generation.",
"enum": [
"unipc",
"dpm++",
"euler"
],
"title": "Sampler"
},
"negative_prompt": {
"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",
"examples": [
"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"
],
"type": "string",
"description": "Negative prompt for video generation.",
"title": "Negative Prompt"
},
"guidance_scale": {
"default": 5,
"minimum": 1,
"maximum": 10,
"type": "number",
"examples": [
5
],
"description": "Guidance scale for classifier-free guidance. Higher values encourage the model to generate images closely related to the text prompt.",
"title": "Guidance Scale"
},
"enable_prompt_expansion": {
"default": false,
"examples": [
false
],
"type": "boolean",
"description": "Whether to enable prompt expansion.",
"title": "Enable Prompt Expansion"
},
"num_frames": {
"default": 81,
"minimum": 17,
"maximum": 241,
"type": "integer",
"description": "Number of frames to generate. Must be between 81 to 241 (inclusive).",
"title": "Number of Frames"
},
"aspect_ratio": {
"default": "auto",
"type": "string",
"description": "Aspect ratio of the generated video.",
"enum": [
"auto",
"16:9",
"1:1",
"9:16"
],
"title": "Aspect Ratio"
},
"ref_image_urls": {
"items": {
"type": "string"
},
"type": "array",
"description": "URLs to source reference image. If provided, the model will use this image as reference.",
"title": "Reference Image URLs"
},
"enable_safety_checker": {
"default": false,
"examples": [
true
],
"type": "boolean",
"description": "If set to true, the safety checker will be enabled. Disabling it requires account authorization; unauthorized requests are always checked.",
"title": "Enable Safety Checker"
},
"num_interpolated_frames": {
"default": 0,
"minimum": 0,
"maximum": 5,
"type": "integer",
"examples": [
0
],
"description": "Number of frames to interpolate between the original frames. A value of 0 means no interpolation.",
"title": "Number of Interpolated Frames"
},
"enable_auto_downsample": {
"default": false,
"examples": [
false
],
"type": "boolean",
"description": "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.",
"title": "Enable Auto Downsample"
},
"shift": {
"default": 5,
"minimum": 1,
"maximum": 15,
"type": "number",
"description": "Shift parameter for video generation.",
"title": "Shift"
},
"prompt": {
"examples": [
"A lone woman strides through the neon-drenched streets of Tokyo at night. Her crimson dress, a vibrant splash of color against the deep blues and blacks of the cityscape, flows slightly with each step. A tailored black jacket, crisp and elegant, contrasts sharply with the dress's rich texture. Medium shot: The city hums around her, blurred lights creating streaks of color in the background. Close-up: The fabric of her dress catches the streetlight's glow, revealing a subtle silk sheen and the intricate stitching at the hem. Her black jacket\u2019s subtle texture is visible \u2013 a fine wool perhaps, with a matte finish. The overall mood is one of quiet confidence and mystery, a vibrant woman navigating a bustling, nocturnal landscape. High resolution 4k."
],
"type": "string",
"description": "The text prompt to guide video generation.",
"title": "Prompt"
},
"video_quality": {
"default": "high",
"examples": [
"high"
],
"type": "string",
"description": "The quality of the generated video.",
"enum": [
"low",
"medium",
"high",
"maximum"
],
"title": "Video Quality"
},
"sync_mode": {
"default": false,
"examples": [
false
],
"type": "boolean",
"description": "If `True`, the media will be returned as a data URI and the output data won't be available in the request history.",
"title": "Sync Mode"
},
"video_url": {
"examples": [
"https://storage.googleapis.com/falserverless/web-examples/wan/t2v.mp4"
],
"type": "string",
"description": "URL to the source video file. Required for outpainting.",
"title": "Video URL"
},
"match_input_num_frames": {
"default": false,
"examples": [
false
],
"type": "boolean",
"description": "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.",
"title": "Match Input Number of Frames"
},
"last_frame_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "URL to the last frame of the video. If provided, the model will use this frame as a reference.",
"title": "Last Frame URL"
},
"auto_downsample_min_fps": {
"default": 15,
"minimum": 1,
"maximum": 60,
"type": "number",
"examples": [
15
],
"description": "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.",
"title": "Auto Downsample Min FPS"
},
"acceleration": {
"default": "regular",
"anyOf": [
{
"type": "string",
"enum": [
"none",
"low",
"regular"
]
},
{
"type": "null"
}
],
"description": "Acceleration to use for inference. Options are 'none' or 'regular'. Accelerated inference will very slightly affect output, but will be significantly faster.",
"examples": [
"regular"
],
"title": "Acceleration"
},
"match_input_frames_per_second": {
"default": false,
"examples": [
false
],
"type": "boolean",
"description": "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.",
"title": "Match Input Frames Per Second"
},
"num_inference_steps": {
"default": 30,
"minimum": 2,
"maximum": 50,
"type": "integer",
"description": "Number of inference steps for sampling. Higher values give better quality but take longer.",
"title": "Number of Inference Steps"
},
"return_frames_zip": {
"default": false,
"examples": [
false
],
"type": "boolean",
"description": "If true, also return a ZIP file containing all generated frames.",
"title": "Return Frames Zip"
},
"first_frame_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "URL to the first frame of the video. If provided, the model will use this frame as a reference.",
"title": "First Frame URL"
},
"interpolator_model": {
"default": "film",
"examples": [
"film"
],
"type": "string",
"description": "The model to use for frame interpolation. Options are 'rife' or 'film'.",
"enum": [
"rife",
"film"
],
"title": "Interpolator Model"
},
"video_write_mode": {
"default": "balanced",
"examples": [
"balanced"
],
"type": "string",
"description": "The write mode of the generated video.",
"enum": [
"fast",
"balanced",
"small"
],
"title": "Video Write Mode"
},
"temporal_downsample_factor": {
"default": 0,
"minimum": 0,
"maximum": 5,
"type": "integer",
"examples": [
0
],
"description": "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.",
"title": "Temporal Downsample Factor"
},
"expand_right": {
"default": false,
"type": "boolean",
"examples": [
true
],
"description": "Whether to expand the video to the right.",
"title": "Expand Right"
},
"expand_top": {
"default": false,
"type": "boolean",
"examples": [
true
],
"description": "Whether to expand the video to the top.",
"title": "Expand Top"
},
"expand_bottom": {
"default": false,
"type": "boolean",
"examples": [
true
],
"description": "Whether to expand the video to the bottom.",
"title": "Expand Bottom"
},
"expand_left": {
"default": false,
"type": "boolean",
"examples": [
true
],
"description": "Whether to expand the video to the left.",
"title": "Expand Left"
},
"expand_ratio": {
"maximum": 1,
"title": "Expand Ratio",
"default": 0.25,
"type": "number",
"minimum": 0,
"description": "Amount of expansion. This is a float value between 0 and 1, where 0.25 adds 25% to the original video size on the specified sides.",
"examples": [
0.25
]
},
"resolution": {
"default": "720p",
"type": "string",
"description": "Resolution of the generated video.",
"enum": [
"480p",
"580p",
"720p"
],
"title": "Resolution"
},
"transparency_mode": {
"default": "content_aware",
"examples": [
"content_aware"
],
"type": "string",
"description": "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.",
"enum": [
"content_aware",
"white",
"black"
],
"title": "Transparency Mode"
},
"seed": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "Random seed for reproducibility. If None, a random seed is chosen.",
"title": "Seed"
},
"frames_per_second": {
"default": 16,
"anyOf": [
{
"minimum": 5,
"maximum": 30,
"type": "integer"
},
{
"type": "null"
}
],
"description": "Frames per second of the generated video. Must be between 5 to 30. Ignored if match_input_frames_per_second is true.",
"title": "Frames per Second"
}
},
"required": [
"prompt",
"video_url"
],
"x-webot-order-properties": [
"prompt",
"negative_prompt",
"match_input_num_frames",
"num_frames",
"match_input_frames_per_second",
"frames_per_second",
"seed",
"resolution",
"aspect_ratio",
"num_inference_steps",
"guidance_scale",
"sampler",
"shift",
"video_url",
"ref_image_urls",
"first_frame_url",
"last_frame_url",
"enable_safety_checker",
"enable_prompt_expansion",
"acceleration",
"video_quality",
"video_write_mode",
"num_interpolated_frames",
"temporal_downsample_factor",
"enable_auto_downsample",
"auto_downsample_min_fps",
"interpolator_model",
"sync_mode",
"transparency_mode",
"return_frames_zip",
"expand_left",
"expand_right",
"expand_top",
"expand_bottom",
"expand_ratio"
],
"title": "WanVACEOutpaintingRequest"
}Output (inside result.output) schema · fields, constraints and defaults
| Parameter | Type | Required | Default when omitted | Description / constraints |
|---|---|---|---|---|
prompt | string | Yes * | No documented default | The prompt used for generation. |
video | object | Yes * | No documented default | The generated outpainting video file. |
video.duration | number | null | No | No documented default | The duration of the video |
video.width | integer | null | No | No documented default | The width of the video |
video.content_type | string | null | No | No documented default | The mime type of the file. |
video.file_size | integer | null | No | No documented default | The size of the file in bytes. |
video.num_frames | integer | null | No | No documented default | The number of frames in the video |
video.height | integer | null | No | No documented default | The height of the video |
video.fps | number | null | No | No documented default | The FPS of the video |
video.url | string | Yes * | No documented default | The URL where the file can be downloaded from. |
video.file_name | string | null | No | No documented default | The name of the file. It will be auto-generated if not provided. |
frames_zip | object | null | No | No documented default | ZIP archive of all video frames if requested. |
frames_zip.variant0.file_size | integer | null | No | No documented default | The size of the file in bytes. |
frames_zip.variant0.content_type | string | null | No | No documented default | The mime type of the file. |
frames_zip.variant0.url | string | Yes * | No documented default | The URL where the file can be downloaded from. |
frames_zip.variant0.file_name | string | null | No | No documented default | The name of the file. It will be auto-generated if not provided. |
seed | integer | Yes * | No documented default | The seed used for generation. |
{
"type": "object",
"properties": {
"prompt": {
"type": "string",
"description": "The prompt used for generation.",
"title": "Prompt"
},
"video": {
"type": "object",
"properties": {
"duration": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"description": "The duration of the video",
"title": "Duration"
},
"width": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "The width of the video",
"title": "Width"
},
"content_type": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"examples": [
"image/png"
],
"description": "The mime type of the file.",
"title": "Content Type"
},
"file_size": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"examples": [
4404019
],
"description": "The size of the file in bytes.",
"title": "File Size"
},
"num_frames": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "The number of frames in the video",
"title": "Num Frames"
},
"height": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "The height of the video",
"title": "Height"
},
"fps": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"description": "The FPS of the video",
"title": "Fps"
},
"url": {
"type": "string",
"description": "The URL where the file can be downloaded from.",
"title": "Url"
},
"file_name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"examples": [
"z9RV14K95DvU.png"
],
"description": "The name of the file. It will be auto-generated if not provided.",
"title": "File Name"
}
},
"required": [
"url"
],
"x-webot-order-properties": [
"url",
"content_type",
"file_name",
"file_size",
"width",
"height",
"fps",
"duration",
"num_frames"
],
"title": "VideoFile",
"description": "The generated outpainting video file.",
"examples": [
{
"url": "https://storage.googleapis.com/falserverless/example_outputs/wan-vace-outpainting-output.mp4"
}
]
},
"frames_zip": {
"anyOf": [
{
"type": "object",
"properties": {
"file_size": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"examples": [
4404019
],
"description": "The size of the file in bytes.",
"title": "File Size"
},
"content_type": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"examples": [
"image/png"
],
"description": "The mime type of the file.",
"title": "Content Type"
},
"url": {
"type": "string",
"description": "The URL where the file can be downloaded from.",
"title": "Url"
},
"file_name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"examples": [
"z9RV14K95DvU.png"
],
"description": "The name of the file. It will be auto-generated if not provided.",
"title": "File Name"
}
},
"required": [
"url"
],
"x-webot-order-properties": [
"url",
"content_type",
"file_name",
"file_size"
],
"title": "File"
},
{
"type": "null"
}
],
"description": "ZIP archive of all video frames if requested."
},
"seed": {
"type": "integer",
"description": "The seed used for generation.",
"title": "Seed"
}
},
"required": [
"video",
"prompt",
"seed"
],
"x-webot-order-properties": [
"video",
"prompt",
"seed",
"frames_zip"
],
"title": "WanVACEOutpaintingResponse"
}Errors and limits
401 invalid/expired/revoked key · 403 key scope or domain mismatch · 404 unavailable model or unowned request · 409 quote changed, balance, concurrency or idempotency conflict · 413 JSON exceeds 2 MB · 415 wrong content type · 422 invalid fields/media · 429 rate limit · 503 temporary/ambiguous submission. Respect Retry-After. Current limits per account: 12 quotes/submissions, 120 result reads and 8 stream connections per minute. One submission preparation at a time per account. Do not automatically regenerate failed jobs.
Your requests
Alibaba Wan - Outpainting · Your account only
Select Requests to load your history.
| Request ID | Created at (IST) | Status | Credits used | Refunded | Processing time | Report |
|---|
Your model analytics
Alibaba Wan - Outpainting · Request dates in IST
Select Analytics to load your metrics.
Request counts
Daily requests by their current status
Request outcomes
Completed, failed and pending requests
Credits used
Daily recorded charges before refunds
Processing time
Daily average for completed requests with recorded timing
Processing percentiles
Completed requests only · Time from submission to recorded completion
How to use Alibaba Wan — Outpainting
This model extends a picture beyond its existing edges by creating new surrounding content.
Required inputs
- Prompt: Your instructions to the model. Say what you want, include the important details and avoid contradictory directions. For a video, describe the action as well as the scene.
- Video URL: The source video or videos. The model needs an accessible file in a supported format. Check length, resolution and audio requirements in the form before submitting.
Workflow
- Prepare your source material and fill the required inputs above. Review the supported settings for this model.
- Sign in to calculate the credit estimate. Review the estimate before choosing Generate.
- Keep this model page open while the request runs. Completed results arrive in the result area; use the available player or download controls to review the output.
When to use this workflow
- Make room around a subject.
- Adapt a picture to a wider or taller composition.
Key settings
- Prompt
- Your instructions to the model. Say what you want, include the important details and avoid contradictory directions. For a video, describe the action as well as the scene.
- Video URL
- The source video or videos. The model needs an accessible file in a supported format. Check length, resolution and audio requirements in the form before submitting.
- Negative Prompt
- Describe things you would prefer the model to avoid, such as unwanted blur or objects. This guides the result but is not a guarantee that those things will never appear.
- Match Input Number of Frames
- Keep the source video’s total frame count where supported. This is different from matching FPS; the final duration depends on both frame count and playback FPS.
- Number of Frames
- The total number of still pictures used to form the clip. This is different from FPS. When playback FPS stays fixed, more frames make a longer clip. For example, 120 frames at 24 FPS last 5 seconds. Some models accept only particular frame counts. Minimum: 17. Maximum: 241
- Match Input Frames Per Second
- Use the source video’s frame rate where supported instead of choosing a separate output rate. This helps keep timing consistent with the input.