Prompt to video
Describe the video you want; the AI writes the script and generates everything.
Requires
source.promptmedia: ai-videovoice-over: on by defaultmusic: on by defaultcaptions: on by defaultratio: 9:16 by default
Build your request
Only the parameters that apply to prompt-to-video are shown. Set values on the left, copy the payload on the right.
source.promptrequiredWhat the video should be about: the AI writes the script. For music-to-video it is an optional creative brief for the visual storyline.
source.stylePromptVisual style instructions, separate from the content prompt (e.g. "dark mood", "pastel watercolor").
source.durationSecondsHint for the script length the AI writes, in seconds.
{
"workflow": "prompt-to-video",
"source": {
"prompt": "A 30-second video about why the ocean is salty, fun and educational"
}
}Free, no API key needed.
Good to know
- →Tune length with options.promptTargetDuration (seconds, or "auto" to let the AI decide).
- →source.stylePrompt steers the visual style; source.durationSeconds hints the script length.
- →Pass characterIds to feature your saved consistent characters.
- →Add a reference image in media.provided[] to guide the visual generation.
- →Set advanced.customCreationParams.fetchNews = true to ground the script in recent news.
Recipes
Prompt with a reference image
AI video guided by an input image used as a visual reference, with the ANIME preset.
{
"webhookUrl": "https://your-server.com/revid/webhook",
"workflow": "prompt-to-video",
"source": {
"prompt": "this is an example",
"durationSeconds": 40
},
"media": {
"type": "ai-video",
"imageModel": "ultra",
"videoModel": "ultra",
"mediaPreset": "ANIME",
"addAudioToVideos": true,
"provided": [
{
"url": "https://cdn.revid.ai/uploads/1777872884798-image.png",
"title": "",
"type": "image"
}
]
},
"voice": {
"enabled": true,
"voiceId": "nPczCjzI2devNBz1zQrb",
"stability": 0.2,
"speed": 1
},
"captions": {
"enabled": true,
"preset": "Ali",
"position": "bottom"
},
"options": {
"promptTargetDuration": 30
},
"aspectRatio": "9:16"
}News to video
Script grounded in recent news fetched for the prompt topic.
{
"webhookUrl": "https://your-server.com/revid/webhook",
"workflow": "prompt-to-video",
"source": {
"prompt": "news about France",
"durationSeconds": 40
},
"media": {
"type": "moving-image",
"density": "medium",
"animation": "dynamic",
"imageModel": "good",
"videoModel": "ultra"
},
"voice": {
"enabled": true,
"voiceId": "cgSgspJ2msm6clMCkdW9",
"speed": 1
},
"captions": {
"enabled": true,
"preset": "Wrap 1",
"position": "bottom"
},
"options": {
"promptTargetDuration": 30,
"fetchNews": true
},
"advanced": {
"customCreationParams": {
"promptCustomRules": "Use recent factual sources and structure as a professional news report."
}
},
"aspectRatio": "9:16"
}