API docs/workflows/script-to-video

Script to video

Turn a written script into a voiced, captioned video with AI visuals.

Requiressource.textalias: voiceover-to-video

media: moving-imagevoice-over: on by defaultmusic: on by defaultcaptions: on by defaultratio: 9:16 by default

Build your request

Only the parameters that apply to script-to-video are shown. Set values on the left, copy the payload on the right.

View as Markdown (for LLMs)

source.textrequired

The exact script to be spoken. For script-to-video it can also be an X/Twitter or LinkedIn post URL: the post content becomes the script.

{
  "workflow": "script-to-video",
  "source": {
    "text": "Did you know honey never spoils? Archaeologists found 3000-year-old honey in Egyptian tombs, still perfectly edible."
  }
}

Free, no API key needed.

Good to know

→`voiceover-to-video` is an accepted alias for this workflow.
→source.text can also be a URL to an X/Twitter or LinkedIn post: the post content becomes the script.
→Use media.type = stock-video for real stock footage instead of AI visuals.
→Use media.type = custom with media.provided[] to use only your own images/videos.

Recipes

Script with your own media, in order

Voiced script where each provided image illustrates the matching script section, no AI media picking.

{
  "webhookUrl": "https://your-server.com/revid/webhook",
  "workflow": "script-to-video",
  "source": {
    "text": "this is a test"
  },
  "media": {
    "type": "custom",
    "density": "medium",
    "imageModel": "cheap",
    "videoModel": "base",
    "useOnlyProvided": true,
    "useProvidedInOrder": true,
    "turnImagesIntoVideos": true,
    "provided": [
      {
        "url": "https://cdn.revid.ai/ai-gen/TAINdpjKn.jpg",
        "title": "An abstract, beautiful shot of three distinct beams of light merging into a single radiant golden source.",
        "type": "image"
      },
      {
        "url": "https://cdn.revid.ai/ai-gen/OZxUbirp4.jpg",
        "title": "Three women appear as silhouettes in front of a giant glowing sun in a dark indigo sky.",
        "type": "image"
      },
      {
        "url": "https://cdn.revid.ai/ai-gen/xA1PjFVGorg.jpg",
        "title": "A woman with a sleek black bob stands in a neon-lit glass hallway with rain outside.",
        "type": "image"
      }
    ]
  },
  "voice": {
    "enabled": true,
    "voiceId": "nPczCjzI2devNBz1zQrb",
    "speed": 1
  },
  "captions": {
    "enabled": true,
    "position": "bottom"
  },
  "aspectRatio": "9:16"
}

Script with stock footage

Voiced script illustrated with real stock videos instead of AI-generated media.

{
  "webhookUrl": "https://your-server.com/revid/webhook",
  "workflow": "script-to-video",
  "source": {
    "text": "this is my video text"
  },
  "media": {
    "type": "stock-video",
    "density": "high"
  },
  "voice": {
    "enabled": true,
    "voiceId": "cgSgspJ2msm6clMCkdW9",
    "stability": 0.2,
    "speed": 1
  },
  "captions": {
    "enabled": true,
    "preset": "Wrap 1",
    "position": "bottom"
  },
  "music": {
    "trackName": "Observer"
  }
}

X/LinkedIn post to video

Pass a post URL as source.text: the post content becomes the script.

{
  "webhookUrl": "https://your-server.com/revid/webhook",
  "workflow": "script-to-video",
  "source": {
    "text": "https://x.com/tibo_maker/status/1848647301998284964"
  },
  "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": {
    "summarizationPreference": "summarize"
  },
  "aspectRatio": "9:16"
}

Quiz video

Quiz video driven by quizzData passed through advanced.customCreationParams.

{
  "webhookUrl": "https://your-server.com/revid/webhook",
  "workflow": "script-to-video",
  "source": {
    "text": "https://x.com/tibo_maker/status/1848647301998284964"
  },
  "media": {
    "type": "moving-image",
    "density": "medium",
    "animation": "dynamic"
  },
  "voice": {
    "enabled": true,
    "voiceId": "cgSgspJ2msm6clMCkdW9",
    "speed": 1
  },
  "captions": {
    "enabled": true,
    "preset": "Wrap 1",
    "position": "bottom"
  },
  "advanced": {
    "customCreationParams": {
      "quizzData": {
        "title": "France",
        "questions": [
          {
            "id": "82e14b8f-07ce-4489-9c35-6d9c10872b4e",
            "question": "What is France",
            "answers": [
              {
                "id": "a62c6e91-da4b-491a-8f36-ba67caa5838a",
                "answer": "a country",
                "isCorrect": true
              },
              {
                "id": "10c89812-22f8-47df-88ef-f11e318fdb1c",
                "answer": "a city",
                "isCorrect": false
              }
            ]
          }
        ]
      }
    }
  },
  "aspectRatio": "9:16"
}

Ad generator All workflows Prompt to video