VideoGen API

Prompt to script

POST

/v1/prompt-to-script

Generate a video script from a prompt. This script can then be passed into POST /script-to-video to generate a video.

Request

Authorization

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Body Params application/json

prompt

string

required

AI prompt that controls the script generation.

targetScriptWordCount

integer

optional

Target word count for the generated script. Not exact, but VideoGen's AI will attempt to generate a script close to this word count.

outputLanguageCode

string

optional

Two letter language code. See https://detectlanguage.com/languages for a list of supported language codes.

websiteUrls

array[string]

optional

List of website URLs to be scanned by VideoGen's AI and included along with the AI prompt to generate the script.

Example

{
  "prompt": "Best restaurants in San Francisco",
  "targetScriptWordCount": 50,
  "websiteUrls": [
    "https://www.chezmamanrestos.com/"
  ]
}

Request samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://ext.videogen.io/v1/prompt-to-script' \
--header 'Content-Type: application/json' \
--data-raw '{
    "prompt": "Best restaurants in San Francisco",
    "targetScriptWordCount": 50,
    "websiteUrls": [
        "https://www.chezmamanrestos.com/"
    ]
}'

Responses

🟢200Successfully generated script

application/json

Body

script

string

required

Generated video script.

Example

{
  "script": "When I think of San Francisco’s culinary scene, Chez Maman instantly comes to mind. It’s not just a restaurant; it’s a cozy embrace of French nostalgia. The burgers with guacamole? Divine. The Brie and wine? A match made in heaven. It’s that perfect blend of comfort and elegance, inviting you to linger."
}

🟠400Failed to generate script

Modified at 2025-04-14 20:37:40

Script to video

Get file