Prompt to video

POST

https://ext.videogen.io/v2/prompt-to-video

This endpoint begins by converting your text prompt and chosen background footage into a complete video script, which is then used to create the video. Upon successful creation, you receive a unique identifier (apiFileId). You can use this apiFileId with the GET /get-file endpoint to monitor the video's export status—the export process generally takes about as long as the video's duration.

For a more automated approach, you may also provide a webhook URL. With this option, status updates are sent directly to your endpoint, eliminating the need for manual polling of the GET /get-file endpoint.

Request

Authorization

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

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

Body Params application/json

Example

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

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://ext.videogen.io/v2/prompt-to-video' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "prompt": "Best restaurants in San Francisco",
    "targetScriptWordCount": 50,
    "websiteUrls": [
        "https://www.chezmamanrestos.com/"
    ]
}'

Responses

🟢200Successfully initiated video generation

application/json

Bodyapplication/json

Examples

SuccessSample Response Request

{
    "apiFileId": "874d3150-f0e3-435c-be3d-0936d892b7e7"
}

🟠400Failed to initiate video generation

Modified at 2025-04-18 02:35:23

Prompt to outline