API docs/workflows/prompt-to-video

Prompt to video

Describe the video you want; the AI writes the script and generates everything.

Requiressource.prompt

media: 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.

View as Markdown (for LLMs)

source.promptrequired

What 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.stylePrompt

Visual style instructions, separate from the content prompt (e.g. "dark mood", "pastel watercolor").

source.durationSeconds

Hint 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"
}

Motion graphics with the pro director

Animated motion graphics scenes rendered with the premium pro director (60 credits/scene). Use media.videoModel: "base" for the cheaper 30 credits/scene tier.

{
  "webhookUrl": "https://your-server.com/revid/webhook",
  "workflow": "prompt-to-video",
  "source": {
    "prompt": "Explain how compound interest works",
    "durationSeconds": 40
  },
  "media": {
    "type": "motion-graphics",
    "videoModel": "pro"
  },
  "voice": {
    "enabled": true,
    "voiceId": "cgSgspJ2msm6clMCkdW9",
    "speed": 1
  },
  "captions": {
    "enabled": true,
    "preset": "Wrap 1",
    "position": "bottom"
  },
  "aspectRatio": "16:9"
}

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"
}

Script to video All workflows Audio to video