Draft video from URL

Draft video from URL

post

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.

Authorizations

bearerAuth

AuthorizationstringRequired

Your ShortGenius API token

Body

application/json

urlstringRequired

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

promptstringOptional

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

localestring · enumOptional

The locale of the video.

Default: autoPossible values:

Responses

200

Successful response

application/json

400

Invalid request

application/json

401

Unauthorized request

application/json

post

/videos/drafts/url

HTTPcURLJavaScriptPython

POST /api/v1/videos/drafts/url HTTP/1.1
Host: shortgenius.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 46

{
  "url": "text",
  "prompt": "text",
  "locale": "auto"
}

{
  "title": "text",
  "caption": "text",
  "scenes": [
    {
      "title": null,
      "caption": "text",
      "image_query": null,
      "first_image_description": null,
      "second_image_description": null,
      "first_image_animation_model": "None",
      "second_image_animation_model": "None"
    }
  ],
  "image_style_recommendations": [
    {
      "preset_id": "123e4567-e89b-12d3-a456-426614174000",
      "reason": "text"
    }
  ],
  "selected_image_style_preset_id": "123e4567-e89b-12d3-a456-426614174000"
}