Ngram icon

Ngram

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

Video → Create From Text

AI-generated

Summary

Create a new video immediately from a text prompt by submitting it to the Ngram API's /videos:fromText endpoint, returning video creation job data for further status tracking.

Inputs

  • Prompt (required) — Text describing the video to create; note that image URLs in this text are not treated as uploaded assets.
  • Voice Name or ID — Select or specify a voice for video narration.
  • Style Name or ID — Select or specify a style for the video.
  • Aspect Ratio — Choose the video's aspect ratio or use the API default.
  • Duration Name or ID — Specify the target video duration in seconds.
  • Animation Mode Name or ID — Select an animation mode for the video.
  • Video Format — Choose video format: Short Video, Video, or API default.
  • Image URLs — Provide public image URLs (one per line) to be processed as uploaded assets.
  • Scenario Name or ID — Optionally set a canonical scenario to guide video generation.
  • Video Type Profile Name or ID — Optionally specify a narrative template profile for the video.
  • Energy Level — Set the video's energy level as a string value.
  • Story Flow — Provide narrative directions such as hooks or tone (max 1024 characters).
  • Deep Research — Boolean to allow more time for research before video generation.

Output shape

a single record containing the submitted video job's data immediately after creation

The response returns immediately with job data under the 'data' property. Use a separate 'On Video Ready' trigger or the Get Status operation to track when the video is completed and retrieve its final URL.

Links

Discussion