Metti in coda generazione video
Queue a new video generation request.
Authentication: This endpoint accepts either a Bearer API key or a SIGN-IN-WITH-X header for x402 wallet-based authentication. The legacy X-Sign-In-With-X header is also accepted during migration. When using x402, a 402 Payment Required response indicates insufficient balance and includes top-up instructions.
/video/quote per ottenere una stima del prezzo, quindi esegui il polling di /video/retrieve con il queue_id restituito fino al completamento.
I modelli privati restituiscono anche un download_url per il video finito. Si tratta di un URL di consegna a breve termine (alcuni retry vanno bene se il download cade); consulta la guida alla generazione video per i dettagli e l’uso opzionale di DELETE per la privacy.
Seedance 2.0
Per i modelliseedance-2-0-* (text-to-video, image-to-video, reference-to-video, oltre alle varianti -fast-*), consulta la guida a Seedance 2.0 per il modello a quattro workflow (Reference / Edit / Extend / Stitch), i pattern di prompt canonici, i limiti di input multimodali e i dettagli sui prezzi.
Consenso Seedance
Quando una richiesta image- o reference-to-video di Seedance contiene un volto umano, l’API restituisce un409 needs_consent con il testo della policy e tu reinvii la stessa richiesta con un’attestazione consents.seedance. Consulta la guida al consenso per i contenuti facciali di Seedance per il flusso completo, l’oggetto di consenso, la deduplica e la revoca.
Upscaling video
Per il modellotopaz-video-upscale, usa upscale_factor (1, 2 o 4) al posto di resolution e fornisci un video_url. La durata e gli FPS vengono rilevati automaticamente dal file video. Consulta la guida all’upscaling video per dettagli ed esempi.
Autorizzazioni
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Corpo
Request body for video generation. Available fields and valid values vary by model.
The model to use for video generation.
"seedance-2-0-text-to-video"
The prompt to use for video generation. Required for most models. The maximum length varies by model (default 2500 characters, up to 10000 for some models such as Seedance 2.0).
1 - 10000"Commerce being conducted in the city of Venice, Italy."
The duration of the video to generate. Available options vary by model.
2s, 3s, 4s, 5s, 6s, 7s, 8s, 9s, 10s, 11s, 12s, 13s, 14s, 15s, 16s, 18s, 20s, 25s, 30s, 1 gen, Auto "10s"
Optional provider-specific consent attestations. Seedance consent is required only when submitted media contains faces.
Optional negative prompt. The maximum length varies by model (default 2500 characters, up to 10000 for some models).
10000"low resolution, error, worst quality, low quality, defects"
The aspect ratio of the video. Available options vary by model. Some models do not support aspect_ratio.
1:1, 2:3, 3:2, 3:4, 4:3, 9:16, 16:9, 21:9 "16:9"
The resolution of the video. Available options vary by model. Some models do not support resolution. Use upscale_factor for upscale models.
256p, 360p, 480p, 540p, 580p, 720p, 1080p, 1440p, 2160p, 4k, 2x, 4x, true_1080p "720p"
For upscale models only. 1 = quality enhancement, 2 = double resolution (default), 4 = quadruple.
1, 2, 4 2
For models which support audio generation and configuration. Defaults to true.
true
For image-to-video models, the reference image. Must be a URL (http/https) or a data URL (data:image/...).
"data:image/png;base64,iVBORw0K..."
For models that support end images or transitions, the end frame image. Must be a URL or data URL.
"data:image/png;base64,iVBORw0K..."
For models that support audio input, background music. Must be a URL or data URL. Supported: WAV, MP3. Max: 30s, 15MB.
"data:audio/mpeg;base64,SUQzBAA..."
For models that support video input (video-to-video, upscale). Must be a URL or data URL. Supported: MP4, MOV, WebM.
"data:video/mp4;base64,AAAAFGZ0eXA..."
For models with reference image support, up to 9 images for character/style consistency. Each must be a URL or data URL.
9["data:image/png;base64,iVBORw0K..."]For models with reference video support (e.g. Seedance 2.0 R2V), up to 3 reference video URLs (role: "reference_video") used to inherit subject motion, camera movement, and overall style. Per-clip 2–15 s, .mp4 or .mov, ≤50 MB; aggregate duration ≤15 s. Each must be a URL or data URL.
3["https://example.com/reference-clip.mp4"]For models with reference audio support (e.g. Seedance 2.0 R2V), up to 3 reference audio URLs (role: "reference_audio") used as donors for vocal timbre, narration, or sound effects. Per-clip 2–15 s, .wav or .mp3; aggregate duration ≤15 s. Must be paired with at least one reference image or reference video — audio-only Reference workflows are rejected at validation. Each must be a URL or data URL.
3["data:audio/mpeg;base64,SUQzBAAAAAA..."]For models with advanced element support (e.g., Kling O3 R2V). Up to 4 elements defining characters/objects. Reference in prompt as @Element1, @Element2, etc.
4[
{
"frontal_image_url": "data:image/png;base64,iVBORw0K...",
"reference_image_urls": ["data:image/png;base64,iVBORw0K..."]
}
]For models with advanced element support. Up to 4 scene reference images. Reference in prompt as @Image1, @Image2, etc.
4["data:image/png;base64,iVBORw0K..."]Risposta
Video generation request queued successfully
The ID of the model used for video generation.
"video-model-123"
The ID of the video generation request.
"123e4567-e89b-12d3-a456-426614174000"
Pre-signed URL to download the completed video. Only present for VPS-backed models. When provided, the retrieve endpoint returns JSON status only (no video stream). Fetch this URL after status is COMPLETED to get the video/mp4 file. Valid for 24 hours.