Draft video

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

bearerAuth

AuthorizationstringRequired

Your ShortGenius API token

Body

application/json

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

/videos/drafts

HTTPcURLJavaScriptPython

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

{
  "topic": "text",
  "duration": "60",
  "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"
}