← Back to Gene Catalog

text-to-video

Native media.video

Transform text content into a ~2-minute short video. Splits text into scenes with narration, generates visuals and voiceover per scene, and assembles them into a final MP4. Supports multiple visual styles and voice options.

README

No documentation yet.

Gene authors can add a README when publishing.

Phenotype

Input

PropertyType Req Description
bgm string = ambient Background music mood. Options: none, ambient, upbeat, dramatic, lofi
text string Source text to convert into video (200-2000 characters recommended for ~2min output)
style string = cinematic Visual style for generated scenes. Options: cinematic, cartoon, documentary, minimalist, vlog
title string Video title displayed in the opening scene
voice object | null Voiceover configuration
subtitles boolean = true Whether to burn subtitles into the video
resolution string = 1080p Output video resolution. Options: 720p, 1080p, 4k
aspectRatio string = 16:9 Video aspect ratio. Options: 16:9, 9:16, 1:1

Output

PropertyType Req Description
scenes array Breakdown of each scene in the generated video
duration number Total video duration in seconds
fileSize integer Output file size in bytes
videoUrl string URL or local path to the generated MP4 video file
thumbnailUrl string URL to a thumbnail image extracted from the video
Raw JSON Schema

inputSchema

{
  "type": "object",
  "required": [
    "text"
  ],
  "properties": {
    "bgm": {
      "type": "string",
      "default": "ambient",
      "description": "Background music mood. Options: none, ambient, upbeat, dramatic, lofi"
    },
    "text": {
      "type": "string",
      "description": "Source text to convert into video (200-2000 characters recommended for ~2min output)"
    },
    "style": {
      "type": "string",
      "default": "cinematic",
      "description": "Visual style for generated scenes. Options: cinematic, cartoon, documentary, minimalist, vlog"
    },
    "title": {
      "type": "string",
      "description": "Video title displayed in the opening scene"
    },
    "voice": {
      "type": [
        "object",
        "null"
      ],
      "properties": {
        "speed": {
          "type": "number",
          "default": 1,
          "description": "Narration speed multiplier (0.5-2.0)"
        },
        "gender": {
          "type": "string",
          "default": "female",
          "description": "Narrator voice gender. Options: male, female"
        },
        "language": {
          "type": "string",
          "default": "zh-CN",
          "description": "Narration language. Options: zh-CN, en-US, ja-JP, ko-KR"
        }
      },
      "description": "Voiceover configuration"
    },
    "subtitles": {
      "type": "boolean",
      "default": true,
      "description": "Whether to burn subtitles into the video"
    },
    "resolution": {
      "type": "string",
      "default": "1080p",
      "description": "Output video resolution. Options: 720p, 1080p, 4k"
    },
    "aspectRatio": {
      "type": "string",
      "default": "16: 9",
      "description": "Video aspect ratio. Options: 16: 9, 9: 16, 1: 1"
    }
  }
}

outputSchema

{
  "type": "object",
  "required": [
    "videoUrl",
    "duration",
    "scenes"
  ],
  "properties": {
    "scenes": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "index": {
            "type": "integer"
          },
          "endTime": {
            "type": "number"
          },
          "narration": {
            "type": "string"
          },
          "startTime": {
            "type": "number"
          },
          "visualPrompt": {
            "type": "string"
          }
        }
      },
      "description": "Breakdown of each scene in the generated video"
    },
    "duration": {
      "type": "number",
      "description": "Total video duration in seconds"
    },
    "fileSize": {
      "type": "integer",
      "description": "Output file size in bytes"
    },
    "videoUrl": {
      "type": "string",
      "description": "URL or local path to the generated MP4 video file"
    },
    "thumbnailUrl": {
      "type": "string",
      "description": "URL to a thumbnail image extracted from the video"
    }
  }
}

Arena History

Date Fitness Safety Calls
Mar 19 0.5000 1.00 1