Happy Horse 1.0 Text to Video API

alibaba/happyhorse-1.0/text-to-video

Happy Horse 1.0 Text to Video transforms natural-language prompts into cinematic short videos, with 3–15 second duration control, 720p or 1080p resolution, and 5 versatile aspect ratios. It faithfully follows scene composition, character action, and camera motion while maintaining visual consistency and physical coherence throughout the clip.

Input

Prompt

287/2500

Resolution

Duration

Aspect ratio

Seed

Safety checker

Output

Idle

Your generated video will appear here

Add your prompt and required media, review the settings, then click Run.

Continue with

Happy Horse 1.0 Image to Video Happy Horse 1.0 Reference to Video Happy Horse 1.0 Video Edit

Examples

A marine researcher kneels beside a glowing tide pool at dawn, gently lifting a small translucent crab with tweezers as waves wash over volcanic rock, soft pink and gold sky, cinematic camera slowly pushing in, natural ambient sound, no text, no logos, no watermark, no promotional marks

Rain pours through a narrow monsoon alley as a bookshop owner pulls a wooden cart of books under a canvas awning, lanterns swaying, reflections rippling in puddles, vertical composition, gentle handheld camera, no text, no logos, no watermark, no promotional marks

A researcher releases a white weather balloon from a windy alpine ridge at sunrise, the balloon rising past snow patches into a deep blue sky, jacket and instrument case tugging in the wind, steady wide shot with slow tilt up, no text, no logos, no watermark, no promotional marks

REST API

Quick Start

Authenticate via API Key, submit prompt instructions, and retrieve the video using the task ID.

Connect to Vidgo API

Create an API Key, store it securely on your server, and set Authorization: Bearer VIDGO_API_KEY.

Endpoint: POSThttps://api.vidgo.ai/api/generate/submit
Authentication: Authorization: Bearer VIDGO_API_KEY

Submit a Generation Task

Configure inputs as shown in the request example with model set to alibaba/happyhorse-1.0/text-to-video.

Submit Request

REQUEST_BODY=$(cat <<'JSON'
{
  "model": "alibaba/happyhorse-1.0/text-to-video",
  "input": {
    "prompt": "A marine researcher kneels beside a glowing tide pool at dawn, gently lifting a small translucent crab with tweezers as waves wash over volcanic rock, soft pink and gold sky, cinematic camera slowly pushing in, natural ambient sound, no text, no logos, no watermark, no promotional marks",
    "duration": 5,
    "resolution": "1080p",
    "aspect_ratio": "16:9"
  }
}
JSON
)

RESPONSE=$(curl --silent --show-error --fail-with-body \
  --request POST \
  --url "https://api.vidgo.ai/api/generate/submit" \
  --header "Authorization: Bearer $VIDGO_API_KEY" \
  --header "Content-Type: application/json" \
  --data "$REQUEST_BODY")

CODE=$(printf '%s' "$RESPONSE" | jq -r '.code // empty')
if [ "$CODE" != "0" ] && [ "$CODE" != "200" ]; then
  printf 'API error: %s
' "$RESPONSE" >&2
  exit 1
fi
printf '%s
' "$RESPONSE"

Await Results

Poll with task_id while status is not_started or running. Stop at finished or failed; read data.files[].file_url on success or data.error_message on failure.

Track Status

GET https://api.vidgo.ai/api/generate/status/{task_id}

Poll every 2 seconds, backing off for extended jobs. Continue only while not_started or running. Alternatively provide callback_url.

not_startedrunningfinishedfailed

Submit Response

{
  "code": 200,
  "data": {
    "task_id": "task-unified-...",
    "status": "running",
    "created_time": "2026-09-17T10:00:00Z"
  }
}

Completed Response

{
  "code": 200,
  "data": {
    "task_id": "task-unified-...",
    "status": "finished",
    "files": [
      {
        "file_url": "https://storage.vidgo.ai/generated/video.mp4",
        "file_type": "video"
      }
    ],
    "created_time": "2026-08-22T10:00:00Z",
    "progress": 100,
    "error_message": null
  }
}

Complete Runnable Example

Expand to inspect complete code including status checks, task_id validation, polling, and timeout boundaries.

Complete Runnable Example

set -euo pipefail
: "${VIDGO_API_KEY:?Set VIDGO_API_KEY in your environment}"

REQUEST_BODY=$(cat <<'JSON'
{
  "model": "alibaba/happyhorse-1.0/text-to-video",
  "input": {
    "prompt": "A marine researcher kneels beside a glowing tide pool at dawn, gently lifting a small translucent crab with tweezers as waves wash over volcanic rock, soft pink and gold sky, cinematic camera slowly pushing in, natural ambient sound, no text, no logos, no watermark, no promotional marks",
    "duration": 5,
    "resolution": "1080p",
    "aspect_ratio": "16:9"
  }
}
JSON
)

SUBMIT_RESPONSE=$(curl --silent --show-error --fail-with-body \
  --request POST \
  --url "https://api.vidgo.ai/api/generate/submit" \
  --header "Authorization: Bearer $VIDGO_API_KEY" \
  --header "Content-Type: application/json" \
  --data "$REQUEST_BODY")

TASK_ID=$(printf '%s' "$SUBMIT_RESPONSE" | jq -r '.data.task_id // .task_id // empty')
BUSINESS_CODE=$(printf '%s' "$SUBMIT_RESPONSE" | jq -r '.code // empty')
if [ "$BUSINESS_CODE" != "0" ] && [ "$BUSINESS_CODE" != "200" ]; then
  printf 'Submit failed:
%s
' "$SUBMIT_RESPONSE" >&2
  exit 1
fi
if [ -z "$TASK_ID" ]; then
  printf 'Submit response did not include task_id:
%s
' "$SUBMIT_RESPONSE" >&2
  exit 1
fi

START_TIME=$(date +%s)
POLL_DELAY=2
while true; do
  if [ $(( $(date +%s) - START_TIME )) -ge 600 ]; then
    printf 'Timed out after 600 seconds
' >&2
    exit 1
  fi
  STATUS_RESPONSE=$(curl --silent --show-error --fail-with-body \
    --url "https://api.vidgo.ai/api/generate/status/$TASK_ID" \
    --header "Authorization: Bearer $VIDGO_API_KEY")
  STATUS=$(printf '%s' "$STATUS_RESPONSE" | jq -r '.data.status // .status // empty')
  BUSINESS_CODE=$(printf '%s' "$STATUS_RESPONSE" | jq -r '.code // empty')
  if [ "$BUSINESS_CODE" != "0" ] && [ "$BUSINESS_CODE" != "200" ]; then
    printf 'Status request failed:
%s
' "$STATUS_RESPONSE" >&2
    exit 1
  fi

  case "$STATUS" in
    finished)
      printf '%s' "$STATUS_RESPONSE" | jq -r '(.data.files // .files // [])[]?.file_url'
      break
      ;;
    failed)
      printf '%s' "$STATUS_RESPONSE" | jq -r '.data.error_message // .error_message // "Generation failed"' >&2
      exit 1
      ;;
    not_started|running)
      sleep "$POLL_DELAY"
      if [ "$POLL_DELAY" -lt 10 ]; then POLL_DELAY=$((POLL_DELAY + 1)); fi
      ;;
    *)
      printf 'Unexpected task status: %s
' "$STATUS" >&2
      exit 1
      ;;
  esac
done

Input Parameters

Available request parameters, data types, and default values. The top-level model field is also required.

Field	Type	Required	Default	Description
prompt	string	Yes	—	String. Up to 2,500 characters. Guides scene layout, character action, and camera movement.
resolution	string	No	1080p	String. Output resolution. Supports 720p and 1080p.
duration	integer	No	5	Integer. Output duration from 3 to 15 seconds.
aspect_ratio	string	No	16:9	String. Output aspect ratio. Supports 16:9, 9:16, 1:1, 4:3, and 3:4.
seed	integer	No	—	Integer. 0 to 2147483647 for reproducible generation foundations.
enable_safety_checker	boolean	No	—	Boolean. Enables content safety moderation for inputs and outputs.

Response Fields

Task submission returns a task_id; status queries yield lifecycle progress and video assets.

Field	Type	Description
code	integer	Business response code, 200 on success.
data.task_id	string	Unique task identifier used to track and poll progress.
data.status	string	Lifecycle state: not_started, running, finished, or failed.
data.progress	integer	Generation completion percentage (0–100).
data.files[].file_url	string	Public URL of the generated video asset.
data.files[].file_type	string	File type string, e.g., video.
data.error_message	string \| null	Failure details when status equals failed.

Task Lifecycle

Continue polling while in not_started or running. Conclude when finished or failed is reached.

not_started
Task is accepted in the queue and awaiting execution.
running
Generation is actively in progress. Continue polling.
finished
Task completed successfully. Read video from data.files[].file_url.
failed
Generation failed. Read data.error_message and stop polling.

Polling & Error Handling

AuthenticationIf HTTP 401 is returned, verify the Bearer API key in the Authorization header.
ValidationIf HTTP 400 is returned, verify required parameters, valid value ranges, and available credits.
Network & TimeoutIf status polling encounters a network timeout, retain the task_id and retry the query.
Polling FrequencyPoll every 2 seconds initially, gradually backing off for longer generations.
Terminal StatesOnly continue polling on not_started or running. Halt on finished or failed.
Callback SupportProvide callback_url in the request payload to receive final task payloads via webhook.

Endpoint Specifications

Specification	Value	Details
Input Mode	Text Prompts Only	Provide a descriptive text prompt detailing the scene, action, and camera motion.
Output Format	MP4 Video	Asynchronous response returns task_id; final result provides downloadable video URL.
Resolution	720p / 1080p	Default preselected to 1080p.
Duration	3–15 seconds	Default preselected to 5 seconds.
Aspect Ratio	16:9 / 9:16 / 1:1 / 4:3 / 3:4	Default preselected to 16:9.
Billing	Per-second rate	720p at 16 credits/s, 1080p at 32 credits/s.

View Happy Horse 1.0 Text to Video API docs

Happy Horse 1.0 Text to Video

Happy Horse 1.0 Text to Video generates cinematic dynamic clips directly from natural-language prompts. Featuring robust prompt following and motion stability, it supports 3–15 seconds of continuous playback, 5 mainstream aspect ratios from 16:9 to 3:4, and 720p or 1080p resolution tiers for social campaigns, narrative storytelling, and visual prototyping.

Key Capabilities & Advantages

Deep Camera Control & Temporal FollowingAccurately parses dolly, pan, tilt, and orbital camera movements, unfolding multi-beat scene choreography in sequential harmony.
3–15s Continuous Motion DurationConfigurable from 3 to 15 seconds in 1-second increments, maintaining physical momentum and environment continuity over extended shots.
720p & 1080p Quality TiersDelivers 720p for rapid concept iteration and 1080p for crisp final asset delivery across creative and production workflows.
5 Standard Aspect RatiosSupports 16:9, 9:16, 1:1, 4:3, and 3:4 framing to seamlessly adapt between cinematic widescreen, square displays, and vertical social feeds.
Seed Reproducibility & Shot IterationPass an optional seed between 0 and 2147483647 to stabilize generation foundations while refining prompt nuances.
Built-in Production Safety ModerationNative safety checker validates inputs and generated outputs in real time, ensuring brand-safe commercial deployment.

Parameters

Parameter	Requirement	Description
prompt	Required	String. Up to 2,500 characters. Guides scene layout, character action, lighting style, and camera trajectory.
resolution	Optional	String. Output resolution. Choose between 720p and 1080p. The Playground preselects 1080p. Default`1080p720p`
duration	Optional	Integer. Output duration from 3 to 15 seconds. The Playground preselects 5 seconds. Default`5346789101112131415`
aspect_ratio	Optional	String. Output aspect ratio. The Playground preselects 16:9. Default`16:99:161:14:33:4`
seed	Optional	Integer. 0 to 2147483647 for reproducible generation foundations.
enable_safety_checker	Optional	Boolean. Enable content moderation check for inputs and outputs.

How to Call Happy Horse 1.0 Text to Video API

Step 1: Get an API KeyLog in to the Vidgo console, generate an API Key, and set Authorization: Bearer VIDGO_API_KEY in your headers.
Step 2: Configure Generation ParametersProvide a descriptive prompt, and optionally configure duration (3–15s), resolution (720p/1080p), and aspect_ratio.
Step 3: Submit Task & Retrieve VideoSend a POST request to /api/generate/submit, poll status with the returned task_id, and access the final video URL.

Happy Horse 1.0 Pricing Overview

Billed per second based on resolution and duration. 720p is 16 credits/s ($0.08/s), and 1080p is 32 credits/s ($0.16/s). Credits are deducted on submission and refunded if the task fails.

Usage	Rate	Details
720p	16 credits/s	Fast iteration; a standard 5s generation costs 80 credits.
1080p	32 credits/s	High-fidelity production; a standard 5s generation costs 160 credits.

Best Use Cases

Cinematic Prototyping & Narrative BeatsQuickly explore complex scenes, camera blocking, and lighting conditions from written scripts before live-action filming.
Marketing & Social Campaign AssetsTurn high-impact copy lines into visually rich marketing hooks, product reveals, and promotional vignettes.
Short-Form Vertical FeedsGenerate dynamic 9:16 videos engineered for maximum engagement across modern mobile content channels.
Concept Art & WorldbuildingBring atmospheric world descriptions and environmental dynamics to life with realistic movement and physical consistency.
E-Commerce Motion ShowcasesAnimate product concepts with controlled camera orbits, studio lighting, and smooth rotational presentation.
AI Video Application PipelinesEasily plug high-quality text-to-video capabilities into automated content creation and publishing workflows via REST API.

Pro Tips

Structure prompts into clear beats: subject appearance, action progression, lighting, and camera trajectory
Select 1080p resolution when fine surface textures and intricate facial expressions are required
Use a fixed seed value to isolate camera and motion adjustments across prompt iterations
Match aspect ratios directly to destination platforms: 16:9 for landscape displays and 9:16 for vertical mobile feeds
Adjust duration between 3 and 15 seconds to give complex physical movements sufficient pacing to resolve
Employ specific cinematography terminology (e.g., slow dolly zoom, low-angle tracking) to direct camera motion

Usage Notes

Specify model as alibaba/happyhorse-1.0/text-to-video in the top-level request body.
The text prompt supports natural-language descriptions up to 2,500 characters.
Duration accepts integer seconds from 3 to 15; resolution accepts 720p or 1080p.
Five standard aspect ratios are supported: 16:9, 9:16, 1:1, 4:3, and 3:4.

Related Models

Gemini Omni 1.1 Flash Text-to-Video preview

Gemini Omni 1.1 Flash Text-to-VideoGoogle Gemini Omni 1.1 Flash video model with native audio, text-to-video, first/last-frame image-to-video, reference-image video, and 3–10 second video edit at 360p to 4K.

Gemini Omni 1.1 Flash Image-to-Video preview

Gemini Omni 1.1 Flash Image-to-VideoGoogle Gemini Omni 1.1 Flash video model with native audio, text-to-video, first/last-frame image-to-video, reference-image video, and 3–10 second video edit at 360p to 4K.

Gemini Omni 1.1 Flash Reference-to-Video preview

Gemini Omni 1.1 Flash Reference-to-VideoGoogle Gemini Omni 1.1 Flash video model with native audio, text-to-video, first/last-frame image-to-video, reference-image video, and 3–10 second video edit at 360p to 4K.

Gemini Omni 1.1 Flash Video Edit preview

Gemini Omni 1.1 Flash Video EditGoogle Gemini Omni 1.1 Flash video model with native audio, text-to-video, first/last-frame image-to-video, reference-image video, and 3–10 second video edit at 360p to 4K.

MiniMax H3 Max Turbo Text to Video preview

MiniMax H3 Max Turbo Text to VideoMiniMax H3 Max Turbo Text to Video turns text into coherent 5–15 second videos with synchronized native stereo audio and fast generation. It follows physical motion while rendering subtle changes in light and shadow.

MiniMax H3 Max Turbo Image to Video preview

MiniMax H3 Max Turbo Image to VideoMiniMax H3 Max Turbo Text to Video turns text into coherent 5–15 second videos with synchronized native stereo audio and fast generation. It follows physical motion while rendering subtle changes in light and shadow.

MiniMax H3 Max Text to VideoMiniMax H3 Max Text to Video turns text prompts into cinematic video with native stereo audio, faster-than-real-time generation, and precise instruction following. It renders complex camera work and physical motion with fine detail across multiple resolutions and common aspect ratios.

MiniMax H3 Max Image to VideoMiniMax H3 Max Text to Video turns text prompts into cinematic video with native stereo audio, faster-than-real-time generation, and precise instruction following. It renders complex camera work and physical motion with fine detail across multiple resolutions and common aspect ratios.

MiniMax H3 Max Reference to Video preview

MiniMax H3 Max Reference to VideoMiniMax H3 Max Text to Video turns text prompts into cinematic video with native stereo audio, faster-than-real-time generation, and precise instruction following. It renders complex camera work and physical motion with fine detail across multiple resolutions and common aspect ratios.

Wan 3.0 Prime Text-to-VideoAlibaba Wan 3.0 Prime video model with text-to-video, image-to-video, and reference-to-video workflows at 480p, 720p, or 1080p for 2 to 30 seconds with optional synchronized audio.

Wan 3.0 Prime Image-to-VideoAlibaba Wan 3.0 Prime video model with text-to-video, image-to-video, and reference-to-video workflows at 480p, 720p, or 1080p for 2 to 30 seconds with optional synchronized audio.

Wan 3.0 Prime Reference-to-Video preview

Wan 3.0 Prime Reference-to-VideoAlibaba Wan 3.0 Prime video model with text-to-video, image-to-video, and reference-to-video workflows at 480p, 720p, or 1080p for 2 to 30 seconds with optional synchronized audio.

Wan 3.0 Text-to-VideoAlibaba Tongyi Lab's Wan 3.0 multimodal video model with separate text-to-video, first/last-frame image-to-video, and reference-to-video workflows at 480p, 720p, or 1080p for 2 to 30 seconds.

Wan 3.0 Image-to-VideoAlibaba Tongyi Lab's Wan 3.0 multimodal video model with separate text-to-video, first/last-frame image-to-video, and reference-to-video workflows at 480p, 720p, or 1080p for 2 to 30 seconds.

Wan 3.0 Reference-to-VideoAlibaba Tongyi Lab's Wan 3.0 multimodal video model with separate text-to-video, first/last-frame image-to-video, and reference-to-video workflows at 480p, 720p, or 1080p for 2 to 30 seconds.

FLUX 3 Text to VideoBlack Forest Labs FLUX 3 video model with text-to-video, image-to-video, first-last-frame, extend-video, and keyframes workflows at 720p or 1080p for 5 to 20 seconds, with optional native audio.

Happy Horse 1.0 Text to Video API Frequently Asked Questions

What is the Happy Horse 1.0 Text to Video API?

Happy Horse 1.0 Text to Video is an Alibaba model for video generation from text. It transforms natural-language prompts into 3–15s cinematic videos with 720p and 1080p resolution options across 5 standard aspect ratios, delivering precise prompt-driven camera motion and stable choreography. Built on an advanced video diffusion architecture, it preserves character anatomy and environmental perspective while adding expressive, physically coherent motion. You can call it programmatically or try it from the playground above.

What aspect ratios does Happy Horse 1.0 Text to Video support?

Happy Horse 1.0 Text to Video supports 16:9, 9:16, 1:1, 4:3, and 3:4. Use 16:9 for landscape widescreen cinema, 9:16 for vertical mobile campaigns, and square or classic framing for product and artistic compositions.

Can Happy Horse 1.0 Text to Video generate 15-second videos?

Yes. The duration parameter accepts any integer second from 3 to 15 seconds, with 5 seconds preselected in the playground. Extended durations maintain consistent prompt fidelity and motion stability.

Does Happy Horse 1.0 Text to Video support 1080p output?

Yes. You can toggle between 720p and 1080p via the resolution parameter. Choose 720p for rapid testing and concept iteration, or 1080p for high-detail production deliverables.

How do prompts control camera motion in Happy Horse 1.0 Text to Video?

Describe subject appearance, scene progression, and clear camera instructions (such as slow push-in, low-angle tracking, or orbital panning) in sequential order, avoiding contradictory movement directives.

Can Happy Horse 1.0 Text to Video reproduce shots using a seed?

Yes. Passing an optional integer seed from 0 to 2147483647 fixes the underlying noise distribution, allowing you to reproduce similar framing or isolate specific prompt adjustments.

When should you choose Happy Horse 1.0 Text to Video over Image to Video?

Choose Text to Video when starting from a script or conceptual prompt with no preexisting visual assets. If you already have a finalized opening still frame to animate, use Image to Video instead.