happyhorse-1.0/text-to-video

Key Features

• Generate video directly from text prompts — no source image required.
• Cinematic quality — produce smooth, coherent video with consistent subjects and scenes.
• Flexible creative control — specify camera angles, lighting, subject actions and mood.
• Multiple duration and resolution options for preview through production workflows.
• Coherent storytelling — maintains narrative consistency across the generated frames.
• Diverse styles — photorealistic, animated, stylized, or abstract visual outputs.

Parameters

How to Use

1. Write a detailed prompt describing your video scene — include subject, action, setting, lighting and camera movement.
2. Select aspect ratio and resolution appropriate for your use case.
3. Set the desired duration for your video clip.
4. Generate and download your video — iterate on the prompt for better results.

Code Examples

import os
import requests

response = requests.post(
    "https://aircube.ai/api/v3/happyhorse-1.0/text-to-video",
    headers={
        "Authorization": "Bearer " + os.environ["AIRCUBE_API_KEY"],
        "Content-Type": "application/json",
    },
    json={
    "prompt": "Aerial shot of a coastal city at golden hour, camera slowly descending toward the waterfront",
    "duration": 8,
    "aspect_ratio": "16:9"
},
    timeout=300,
)
data = response.json()

if data["success"]:
    print("ID:", data["data"]["id"], "Status:", data["data"]["status"])
else:
    print("Error:", data["error"]["message"])

Pricing

Billing rules

• 720p / 5s: $0.40.
• 1080p / 5s: $0.71.
• Longer durations scale proportionally.
• Failed generations are not charged.

Best Use Cases

• Content creation — generate video clips for social media, ads and marketing campaigns.
• Storyboard visualization — bring written concepts to life as video previews.
• Music video production — create visual sequences from lyrical descriptions.
• Educational content — generate explainer or demonstration clips from descriptions.
• Game and film pre-visualization — prototype scenes before full production.

Pro Tips

• Write prompts like a film director — include specific camera angles (close-up, wide shot, tracking shot).
• Describe lighting conditions (golden hour, dramatic shadows, neon glow) for mood control.
• Keep the scene description focused — one clear action or sequence per generation works best.
• Include temporal cues (slowly, suddenly, gradually) to guide the pacing of motion.
• Start with 16:9 for cinematic content and 9:16 for social media verticals.

Notes

• Video output is typically MP4 format.
• Generation time scales with duration and resolution.
• Complex prompts with multiple subjects may require iteration to achieve desired results.