Ngram icon

Ngram

Generate AI videos from prompts, text, and URLs, then check render status.

Video → Create From URL

AI-generated

Summary

Create a new AI-generated video by submitting a webpage, article, product page, or document URL for Ngram to research and transform into video content.

Inputs

  • Website URL (required) — Page, article, product page, or document URL that Ngram will research to create the video.
  • Prompt — Optional instructions guiding how Ngram should use the content from the URL in the video.
  • Voice Name or ID — Select or specify a voice for the video narration.
  • Style Name or ID — Select or specify a style to define the video's visual and narrative aesthetic.
  • Aspect Ratio — Choose the video's aspect ratio (e.g., 1:1, 16:9, 9:16) or use the API default.
  • Duration Name or ID — Target video duration in seconds.
  • Animation Mode Name or ID — Select an animation mode for the video.
  • Video Format — Choose between a standard video, short video (silent 15-second hybrid), or use API default.
  • Image URLs — Provide public image URLs, one per line, to be uploaded and used as assets in the video.
  • Scenario Name or ID — Select a canonical scenario ID to guide video structure or leave blank for free-form prompts.
  • Video Type Profile Name or ID — Optional narrative template selecting from Ngram's prebuilt story patterns.
  • Energy Level — Specify the energy level or tone for the video narration.
  • Story Flow — Optional narrative direction such as hook, proof points, call to action, or tone (max 1024 characters).
  • Deep Research — Enable to allow Ngram more time researching source material before video generation.

Output shape

a single record containing detailed metadata about the submitted video creation job, including its ID, initial status, and related properties.

The operation returns immediately with a video job object in the response's 'data' property; the video itself is not immediately available. Use the "On Video Ready" trigger or the "Get Status" operation to track completion and retrieve the final video URL.

Links

Discussion