Text to Video

Overview

Text to Video helps creators, video editors, advertisers, e-commerce teams, social-commerce teams, and short-form story producers turn a written brief into an AI video with AI Hive. Describe the intended subject, action, camera, lighting, pacing, and constraints; the bundled CLI handles AI Hive OpenAPI calls and downloads the finished video.

Why use this skill

• Brief to result: work from plain-English creative direction instead of writing API requests
• Controlled inputs: use the exact first frame, last frame, image, video, or audio references required by this capability
• Predictable model selection: the skill name matches the public model ID used by the script
• Live pricing: fetch the active model configuration and pricing snapshot before submission
• Production-friendly delivery: preserve the task ID, poll one task safely, and download results automatically

Best for

Ads, tvcs, product videos, e-commerce listings, social commerce, ugc-style seeding content, short dramas, motion comics, and storyboards. It is also useful when users search for text-to-video, T2V, prompt-to-video, AI video generation.

Capabilities

Mode	Capability	publicModelId
t2v	Text to Video	public_model_seedance_2_5_t2v

The default route is COST_FIRST. Pass live model options with --param key=value; supported values come from the current AI Hive videoConfig.

Quick Start

pip3 install requests
python3 "$SKILL_PATH/scripts/videogen.py" init --skill-name text-to-video
python3 "$SKILL_PATH/scripts/videogen.py" generate \
  --mode t2v \
  --prompt "Text to Video: polished motion, clear subject, coherent action, stable camera, commercial finish"

Usage Scenarios

1. Core generation

python3 "$SKILL_PATH/scripts/videogen.py" generate --mode t2v \
  --prompt "Create a polished text to video result with coherent motion, stable identity, and a clear ending"

2. Advertising and TVC

python3 "$SKILL_PATH/scripts/videogen.py" generate --mode t2v \
  --prompt "Premium product commercial: establish the product, reveal materials with controlled camera movement, finish on a clean brand-ready hero frame"

3. E-commerce and product showcase

python3 "$SKILL_PATH/scripts/videogen.py" generate --mode t2v \
  --prompt "E-commerce product video: centered subject, move from full product view to material close-ups, show one real use case, leave space for product copy"

4. Social commerce and seeding content

python3 "$SKILL_PATH/scripts/videogen.py" generate --mode t2v \
  --prompt "Vertical social-commerce video: open with the customer problem, demonstrate the product naturally, show the practical benefit, end with a clean call-to-action frame"

5. Short drama and motion comic

python3 "$SKILL_PATH/scripts/videogen.py" generate --mode t2v \
  --prompt "Short-drama shot: a young detective opens an abandoned warehouse door, pauses, and looks inside; slow over-shoulder push-in, cold suspense lighting, one continuous action"

6. Reference-controlled or channel-specific version

python3 "$SKILL_PATH/scripts/videogen.py" generate --mode t2v \
  --prompt "Keep the subject and visual identity consistent; use the reference for motion and camera rhythm; create a tighter social-media version with a brand-ready ending"

7. Submit now and check later

python3 "$SKILL_PATH/scripts/videogen.py" generate --mode t2v --prompt "Complex production brief" --no-download
python3 "$SKILL_PATH/scripts/videogen.py" task --task-id <taskId>

Command Reference

Option	Purpose
--mode	Select a supported mode; capability-specific skills already fix it
--prompt	Describe the video or edit
--first-frame / --last-frame	Supply controlled keyframes
--image / --video / --audio	Supply reference media
--param key=value	Pass live model parameters
--routing COST_FIRST	Select the cost-first route
--no-download	Submit and return the task ID without waiting

API Key

Run the init command above, or set AI_HIVE_API_KEY, use --api-key, or create ~/.ai-hive/config.json. API keys use the sk-api-* format. Never commit a real API key.

Reliability and Cost

The script looks up the live model entry and pricing snapshot at runtime. Model availability, accepted media, parameters, and prices can change. Keep a returned task ID and query the existing task instead of submitting a duplicate that may be billed twice.

Troubleshooting

• Missing media: provide the first frame, reference image, reference video, or reference audio required by this skill.
• 401 Unauthorized: verify that the API key is complete, active, and not committed to source control.
• Invalid parameter: inspect the current videoConfig for accepted values and media limits.
• Local timeout: keep the task ID and use the task command later.