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

PreviousVideosNextDraft video from script

Last updated 3 months ago

Draft video

post

Write a video on the provided topic. After calling this endpoint, call Create Video with the results to create the video.

Authorizations
Body
topicstringRequired

The topic to write a video about.

durationstring · enumRequired

Desired duration in seconds of the final script. This is a best-effort basis (always verify credit cost).

Possible values:
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 HTTP/1.1
Host: shortgenius.com
Authorization: Bearer JWT
Content-Type: application/json
Accept: */*
Content-Length: 48

{
  "topic": "text",
  "duration": "60",
  "locale": "auto"
}
{
  "title": "text",
  "caption": "text",
  "scenes": [
    {
      "title": null,
      "caption": "text",
      "first_image_description": "text",
      "second_image_description": "text"
    }
  ]
}