Draft video from URL

Retrieve the content of a webpage and write a video based on it. Only text is currently supported -- the AI cannot watch videos. After calling this endpoint, call Create Video with the results to create the video.

post

/videos/drafts/url

Authorizations

Body

urlstringrequired

URL of a webpage to summarize into a video. Only textual data can be processed; sites that block requests may fail.

promptstring

Instructions for the AI that is reading the webpage and writing the script.

localestring · enum · default: auto

The locale of the video.

Options: af-ZA, id-ID, ms-MY, ca-ES, cs-CZ, da-DK, de-DE, en-US, es-ES, es-419, fr-CA, fr-FR, hr-HR, it-IT, hu-HU, nl-NL, no-NO, pl-PL, pt-BR, pt-PT, ro-RO, sk-SK, fi-FI, sv-SE, vi-VN, tr-TR, el-GR, ru-RU, sr-SP, uk-UA, hy-AM, he-IL, ur-PK, ar-SA, hi-IN, th-TH, ko-KR, ja-JP, zh-CN, zh-TW, auto

Responses

application/json

cURL

JavaScript

Python

HTTP

curl -L \
  --request POST \
  --url 'https://shortgenius.com/api/v1/videos/drafts/url' \
  --header 'Authorization: Bearer JWT' \
  --header 'Content-Type: application/json' \
  --data '{
    "url": "text",
    "prompt": "text",
    "locale": "auto"
  }'

200

400

401

{
  "title": "text",
  "caption": "text",
  "scenes": [
    {
      "title": null,
      "caption": "text",
      "first_image_description": "text",
      "second_image_description": "text"
    }
  ]
}

Successful response