ShortGenius API
ShortGeniusDevelopers
  • Introduction
  • Quickstart
  • Authentication & Essentials
  • API reference
    • Videos
      • Draft video
      • Draft video from script
      • Draft video from URL
      • Draft quiz video
      • Draft news video
      • Create video
      • List videos
      • Get video
      • Generate video topics
    • Video series
      • Generate video topics
      • Create series
      • List series
      • Get series
    • Images
      • Create image
      • List images
      • Get image
      • Get image styles
    • Audio
      • Create speech
      • List audio
      • Get audio
      • List voices
      • Get voice
    • Music
      • List music genres
      • List music
    • Publishing
      • List connections
    • Administration
      • Get usage
      • Health check
  • Guides
    • Video Generation
    • Video Series
    • Image Generation
    • Audio Generation
    • Music
    • Publishing
    • Usage & Credits
  • Resources
    • Realtime logs
    • API keys
    • OpenAPI spec
    • TypeScript SDK
    • Python SDK
    • ShortGenius
Powered by GitBook
On this page
  1. API reference
  2. Videos

Draft video from URL

PreviousDraft video from scriptNextDraft quiz video

Last updated 3 months ago

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
Body
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
POST /api/v1/videos/drafts/url HTTP/1.1
Host: shortgenius.com
Authorization: Bearer JWT
Content-Type: application/json
Accept: */*
Content-Length: 46

{
  "url": "text",
  "prompt": "text",
  "locale": "auto"
}
{
  "title": "text",
  "caption": "text",
  "scenes": [
    {
      "title": null,
      "caption": "text",
      "first_image_description": "text",
      "second_image_description": "text"
    }
  ]
}