Create a new motion graphics video generation job

Creates a new motion graphics generation job. Submit your prompt and desired output formats to queue a video for generation.

Request body

promptstring required

Text prompt describing the motion graphics/video to generate. Be specific about subject, style, motion, and colors for best results.

reference_image_urlstring

URL of a single reference image to guide visual style or content. Use reference_image_urls instead if you have multiple images.

reference_image_urlsstring[]

Up to 5 reference image URLs to guide visual style or content. Preferred over reference_image_url when providing multiple images.

reference_video_urlstring

Optional URL of a reference video.

duration_secondsnumber

Duration (in seconds) for the generated video. Optional. Range: 1–120. If omitted, default or parent is used.

style_idstring

Optional ID of a style to use for styling the video.

brand_kit_idstring

[Deprecated] Optional ID of a style to use for styling the video. Use style_id instead.

parent_video_idstring

Video ID or template ID to use as a starting point for this generation. Useful for iterations on a previous result or starting from a template.

sound_effectsboolean

[Beta] When true, generates sound effects for the video

Example request

{
  "prompt": "A spinning rainbow wheel.",
  "duration_seconds": 8,
  "outputs": [
    {
      "format": "mp4",
      "aspect_ratio": "16:9",
      "fps": "30",
      "resolution": "1080p"
    }
  ]
}

Response

Job successfully queued. Returns a job/video ID.

video_idstring required

Unique ID of the job/video that was created.

project_urlstring

Optional URL to view the project in the user interface.

v1

Create a new motion graphics video generation job

Request body

Example request

Response