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

Request

  • Base URL: https://api.shortgenius.com/v1
  • URL: https://api.shortgenius.com/v1/videos
  • Auth: HTTP bearer

Request body

content_type'Custom' | 'News' | 'Quiz' | 'History' | 'Scary' | 'Motivational' | 'Bedtime' | 'FunFacts' | 'LifeTips' | 'ELI5' | 'Philosophy' | 'Blog' | 'Ad'
locale'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'

Locale for the generated video.

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.

image_model'OpenAI' | 'Flux Ultra/Max' | 'Flux Pro' | 'Flux 2 Pro'

Image model for the generated video.

image_quality'low' | 'medium' | 'high'

Image quality for the generated video.

image_style_raw_modeboolean

Whether to use the raw image style mode. If true, the image style will be ignored.

image_style_custom_promptstring

Custom prompt for the image style. If you provide a custom prompt, the image style will be ignored.

animation_model'None' | 'Seedance' | 'Kling' | 'Hailuo02Standard' | 'Hailuo02Pro' | 'Veo3' | 'SeedanceTTV'

Default animation model for scene images when not specified individually.

animation_model_preset'fully_animated' | 'first_scene_only' | 'first_image_each_scene'

Default animation preset for scene images when not specified individually.

connection_idsstring[] required

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

aspect_ratio'9:16' | '16:9' | '1:1'

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

voice_playback_ratenumber

Voice playback speed percentage.

voice_volumenumber

Voice volume percentage.

soundtrack_playback_ratenumber

Soundtrack playback speed percentage.

soundtrack_volumenumber

Soundtrack volume percentage.

titlestring required

The title of the video.

captionstring required

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

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.

Response

Successful response

idstring uuid required
titlestring nullable
captionstring nullable
created_atstring required

Date and time (ISO 8601) when the video was created.

updated_atstring nullable

Date and time (ISO 8601) when the video was last updated.

series_idstring uuid required

ID of the associated series.

publishing_state'pending' | 'processing' | 'completed' | 'skipped' | 'error' required

Upload status of the video.

publish_atstring nullable required

Date and time (ISO 8601) when the video was fully uploaded.

Changes

No recorded changes to this operation across all 1 revision of this API.