> ## Documentation Index
> Fetch the complete documentation index at: https://docs.magnific.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Happy Horse 1.1 Text To Video API

> Generate AI videos from text prompts with Happy Horse 1.1. 720P and 1080P resolution, 9 aspect ratios, and 3-15 second durations, from Alibaba ATH.

<Card title="Alibaba ATH Happy Horse 1.1 integration" icon="video">
  Happy Horse 1.1 is the latest iteration of Alibaba ATH's flagship video model, delivering state-of-the-art motion fidelity, prompt adherence, and visual quality, now with 9 aspect ratios for text-to-video.
</Card>

Happy Horse 1.1 Text-to-Video is an AI video generation API that creates MP4 videos from text descriptions. Built by Alibaba ATH (Taotian Innovation Unit, led by Zhang Di), it produces high-fidelity video with cinematic motion at 720P (1280x720) or 1080P (1920x1080) resolution, supports 9 configurable aspect ratios, and durations from 3 to 15 seconds.

### Key capabilities

* **State-of-the-art quality**: Latest iteration of the Alibaba ATH Happy Horse video family
* **Resolution options**: 720P (1280x720) and 1080P (1920x1080) output
* **9 aspect ratios**: `16:9`, `9:16`, `1:1`, `4:3`, `3:4`, `21:9`, `9:21`, `5:4`, `4:5`
* **Flexible durations**: 3 to 15 seconds of video output (default 5 seconds)
* **Multilingual prompts**: Up to 2500 characters describing scene, motion, and style
* **Reproducible results**: Fixed seed support (0 to 2147483647) for consistent generation
* **Async processing**: Webhook notifications or polling for task completion

### Use cases

* **Marketing videos**: Create product showcases and brand content from text descriptions
* **Social media content**: Generate short-form videos for TikTok, Instagram, and YouTube in portrait or landscape
* **Concept visualization**: Transform ideas and scripts into motion for rapid prototyping
* **Educational content**: Illustrate concepts with AI-generated video explanations
* **Storyboarding**: Pre-visualize scenes from a script before live production
* **Creative exploration**: Experiment with text prompts and aspect ratios for unique visual content

### API operations

Generate videos by submitting a text prompt to the API. The service returns a task ID for async polling or webhook notification.

<div className="my-11">
  <Columns cols={2}>
    <Card title="POST /v1/ai/text-to-video/happy-horse-1-1" icon="video" href="/api-reference/text-to-video/happy-horse-1-1/generate">
      Create a new text-to-video generation task
    </Card>

    <Card title="GET /v1/ai/text-to-video/happy-horse-1-1" icon="list" href="/api-reference/text-to-video/happy-horse-1-1/happy-horse-1-1-t2v-tasks">
      List all Happy Horse 1.1 T2V tasks with status
    </Card>

    <Card title="GET /v1/ai/text-to-video/happy-horse-1-1/{task-id}" icon="magnifying-glass" href="/api-reference/text-to-video/happy-horse-1-1/task-by-id">
      Get task status and results by ID
    </Card>
  </Columns>
</div>

### Parameters

| Parameter      | Type      | Required | Default   | Description                                                                                       |
| -------------- | --------- | -------- | --------- | ------------------------------------------------------------------------------------------------- |
| `prompt`       | `string`  | Yes      | -         | Text description of the video. Max 2500 characters                                                |
| `aspect_ratio` | `string`  | No       | `"16:9"`  | Output ratio: `"16:9"`, `"9:16"`, `"1:1"`, `"4:3"`, `"3:4"`, `"21:9"`, `"9:21"`, `"5:4"`, `"4:5"` |
| `resolution`   | `string`  | No       | `"1080P"` | Output resolution: `"720P"` or `"1080P"`                                                          |
| `duration`     | `integer` | No       | `5`       | Video length in seconds: 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15                              |
| `seed`         | `integer` | No       | Random    | Seed for reproducibility (0 to 2147483647)                                                        |
| `webhook_url`  | `string`  | No       | -         | URL for async status notifications                                                                |

When the task completes, the generated MP4 video URL is returned in `data.generated`. The URL is valid for 24 hours — download and persist it to permanent storage immediately.

## Frequently Asked Questions

<AccordionGroup>
  <Accordion title="What is Happy Horse 1.1 and who built it?">
    Happy Horse 1.1 is an AI video generation model developed by Alibaba ATH (Taotian Innovation Unit), led by Zhang Di. It is the latest iteration of the Happy Horse video family and generates high-fidelity MP4 video from text prompts.
  </Accordion>

  <Accordion title="How does Happy Horse 1.1 Text-to-Video work?">
    Submit a text prompt describing your desired video, receive a task ID immediately, then poll the GET endpoint or wait for a webhook notification when processing completes. The model generates an MP4 video at 720P or 1080P resolution in durations from 3 to 15 seconds.
  </Accordion>

  <Accordion title="What aspect ratios does Happy Horse 1.1 support?">
    Happy Horse 1.1 T2V supports 9 aspect ratios: `16:9`, `9:16`, `1:1`, `4:3`, `3:4`, `21:9`, `9:21`, `5:4`, and `4:5`. The default is `16:9`.
  </Accordion>

  <Accordion title="What durations are available?">
    Happy Horse 1.1 T2V supports integer durations from 3 to 15 seconds. The default is 5 seconds. Allowed values: 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15.
  </Accordion>

  <Accordion title="How long does video generation take?">
    Processing time depends on resolution, duration, and server load. Higher resolution (1080P) and longer durations take more time. For production workflows, use webhooks instead of polling for scalable integration.
  </Accordion>

  <Accordion title="What are the rate limits for Happy Horse 1.1?">
    Rate limits depend on your subscription tier. See the [Rate Limits](/ratelimits) page for current limits by plan.
  </Accordion>

  <Accordion title="How much does Happy Horse 1.1 cost?">
    See the [Pricing page](/pricing) for current rates and subscription options.
  </Accordion>

  <Accordion title="What is the difference between Happy Horse 1.1 and Happy Horse 1.0?">
    Both are Alibaba ATH video models. Happy Horse 1.1 is the newer iteration and expands text-to-video and reference-to-video to 9 aspect ratios (`16:9`, `9:16`, `1:1`, `4:3`, `3:4`, `21:9`, `9:21`, `5:4`, `4:5`) versus 5 in 1.0. Choose Happy Horse 1.1 for the latest quality and wider aspect ratio coverage.
  </Accordion>
</AccordionGroup>

## Best practices

* **Prompt writing**: Be specific about scenes, characters, camera movements (zoom, pan, tilt), lighting, and atmosphere. Detailed prompts produce better results than vague descriptions.
* **Duration selection**: Start with shorter durations (3-5 seconds) for quick iterations, then increase for final outputs.
* **Reproducibility**: Save the `seed` value from successful generations to recreate similar results with the same parameters.
* **Production integration**: Use webhooks for scalable applications instead of polling.
* **Error handling**: Implement retry with exponential backoff for 503 errors during high-demand periods.

## Related APIs

* **[Happy Horse 1.1 Image-to-Video](/api-reference/image-to-video/happy-horse-1-1/overview)**: Animate a single image into video with Happy Horse 1.1
* **[Happy Horse 1.1 Reference-to-Video](/api-reference/reference-to-video/happy-horse-1-1/overview)**: Generate videos from up to 9 character reference images
* **[Happy Horse 1.0 Text-to-Video](/api-reference/text-to-video/happy-horse-1/overview)**: Previous Happy Horse iteration, ranked #1 on the Artificial Analysis Video Arena (April 2026)