Create video

Create video

Before using this endpoint, call one of the following endpoints to generate and review your video's content:

• Draft video
• Draft video from URL
• Draft video from script
• Draft quiz video
• Draft news video

Once you (or your LLM) are happy, you can pass the content to this endpoint to create and render the video.

post

/videos

Authorizations

Body

content_typestring · enum · default: Custom

Options: Custom, News, Quiz, History, Scary, Motivational, Bedtime, FunFacts, LifeTips, ELI5, Philosophy

localestring · enum · default: auto

Locale for the generated 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

image_style_idstring · uuid

The ID of the image style to use. Use the List image styles endpoint to get a list of available image styles. If left empty, the AI chooses.

connection_idsstring · uuid[]required

List of publishing connection ids. Use the List connections endpoint to get a list of available connections

aspect_ratiostring · enum · default: 9:16

Aspect ratio of the video. Not required for News videos.

Options: 9:16, 16:9, 1:1

voice_playback_ratenumber · min: 50 · max: 200 · default: 100

Voice playback speed percentage.

voice_volumenumber · max: 100 · default: 100

Voice volume percentage.

soundtrack_playback_ratenumber · min: 50 · max: 200 · default: 100

Soundtrack playback speed percentage.

soundtrack_volumenumber · max: 100 · default: 100

Soundtrack volume percentage.

titlestringrequired

The title of the video.

captionstringrequired

The description shown beside the video when posted to social media.

scenesobject[]

Scene suitable for a video.

quizobject

Quiz content to be converted into a single video. Required for Quiz videos.

voice_idstring

The voice to use for speech generation. See the List voices endpoint. If left empty, the AI chooses.

soundtrack_idstring · uuid

Id of the soundtrack to use for background music. See the List music endpoint for available genres, and the List music tracks endpoint for available soundtracks. If left empty, the AI chooses.

publish_atstring

Scheduled time for publishing the video. Format in ISO 8601. If left empty, it will be published 1 hour after the video is created.

Responses

application/json

application/json

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url 'https://shortgenius.com/api/v1/videos' \
  --header 'Authorization: Bearer JWT' \
  --header 'Content-Type: application/json' \
  --data '{
    "content_type": "Custom",
    "locale": "auto",
    "image_style_id": "123e4567-e89b-12d3-a456-426614174000",
    "connection_ids": [
      "123e4567-e89b-12d3-a456-426614174000"
    ],
    "aspect_ratio": "9:16",
    "voice_playback_rate": 100,
    "voice_volume": 100,
    "soundtrack_playback_rate": 100,
    "soundtrack_volume": 100,
    "title": "text",
    "caption": "text",
    "scenes": [
      {
        "title": null,
        "caption": "text",
        "first_image_description": "text",
        "second_image_description": "text"
      }
    ],
    "quiz": {
      "questions": [
        {
          "question": "text",
          "options": [
            {
              "text": "text",
              "correct": true
            }
          ]
        }
      ],
      "results": {
        "header": "text",
        "explanation": "text",
        "categories": [
          {
            "score_range": "text",
            "title": "text"
          }
        ]
      }
    },
    "voice_id": "text",
    "soundtrack_id": "123e4567-e89b-12d3-a456-426614174000",
    "publish_at": "text"
  }'

200

400

401

200

{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "title": null,
  "caption": null,
  "created_at": "text",
  "updated_at": null,
  "series_id": "123e4567-e89b-12d3-a456-426614174000",
  "publishing_state": "pending",
  "publish_at": null
}

Successful response