from scripts.tomoviee_text2video_client import TomovieeText2VideoClient

client = TomovieeText2VideoClient("app_key", "app_secret")

API Usage

Basic Example

task_id = client.text_to_video(
    prompt="Golden retriever running through sunlit meadow, slow motion, cinematic",
    resolution="720p",
    aspect_ratio="16:9",
    camera_move_index=5
)

result = client.poll_until_complete(task_id)
import json
video_url = json.loads(result['result'])['video_path'][0]

Parameters

prompt (required): Text description (subject + action + scene + camera + lighting)
resolution: 720p or 1080p (default: 720p)
duration: Duration in seconds (only 5 supported)
aspect_ratio: 16:9, 9:16, 4:3, 3:4, 1:1
camera_move_index: Camera movement type (1-46, optional)

Async Workflow

Create task: Get task_id from API call
Poll for completion: Use poll_until_complete(task_id)
Extract result: Parse returned JSON for video URL

Status codes:

1 = Queued
2 = Processing
3 = Success (ready)
4 = Failed
5 = Cancelled
6 = Timeout

Generation time: 1-5 minutes per 5-second video

Camera Movements

All video APIs support 46 camera movement types via camera_move_index:

5 = Slow zoom in
12 = Pan right
23 = Orbit/circular
None = Auto-select

See references/camera_movements.md for all 46 types.

Prompt Engineering

Effective prompts improve output quality dramatically.

Formula: Subject + Motion + Scene + Camera + Lighting + Atmosphere

Example:

"Red Ferrari speeding along coastal highway, camera tracking from side, golden hour sunset, cinematic and epic"

See references/prompt_guide.md for detailed guidance.

Resources

scripts/

tomoviee_text2video_client.py - Text-to-Video API client
generate_auth_token.py - Auth token generator

references/

video_apis.md - Detailed video API documentation
camera_movements.md - All 46 camera movement types
prompt_guide.md - Prompt engineering guide and best practices

External Resources

Developer Portal: https://www.tomoviee.ai/developers.html
API Documentation: https://www.tomoviee.ai/doc/
Get API Credentials: Register at developer portal

tomoviee-text2video

Tomoviee AI - 文生视频 (Text-to-Video)

Overview

Quick Start

Authentication

Python Client