> ## Documentation Index > Fetch the complete documentation index at: https://docs.vidgo.ai/llms.txt > Use this file to discover all available pages before exploring further. # Happy Horse 1.1 Text to Video > Generate short video scenes with Happy Horse 1.1, with output up to 1080p and framing from wide cinematic layouts to tall vertical video. 1. Submit the request with `VIDGO_API_KEY`. A `task_id` is returned immediately. Keep it until the task reaches `finished` or `failed`. 2. Use [Query Task Status](/api-manual/task-management/status) to retrieve the result. If you provide a `callback_url`, Vidgo sends the result to your [webhook](/api-manual/task-management/webhooks) when the task finishes or fails. # Happy Horse 1.1 Text to Video Generate short video scenes with Happy Horse 1.1, with output up to 1080p and framing from wide cinematic layouts to tall vertical video. ## Available Models * **alibaba/happyhorse-1.1/text-to-video** - Generate video scenes from text prompts. ## Duration Options * **3-15 seconds** - Set `duration` as an integer. Optional. Default: **5 seconds**. ## Key Features * Generate video scenes from text prompts. * Choose from `720p`, `1080p` output resolutions. ## Advanced Parameters Set `model` and optional `callback_url` at the request root. Place all workflow parameters, including output options, inside `input`. Send only the input fields supported by this workflow. Unsupported `input` fields are rejected before credits are deducted. Input URLs must use HTTP(S), include a hostname, and contain no embedded credentials. `duration` and `seed` also accept integer strings such as `"5"`; decimal numbers such as `5.0` and decimal strings such as `"5.0"` are rejected. Null or empty values use the default duration or omit the seed. Supported boolean fields also accept `0`/`1` and case-insensitive strings `true`/`false`, `1`/`0`, `yes`/`no`, `y`/`n`, and `on`/`off`; null omits the field. Surrounding whitespace is trimmed, and resolution values are case-insensitive. ### Prompt * `prompt`: Required. Describe the scene and desired motion. Maximum: **2,500 Unicode characters**. * Leading and trailing whitespace is trimmed. A nonblank prompt is required. ### Aspect Ratio * `aspect_ratio`: Optional. Accepted values: `21:9`, `16:9`, `4:3`, `1:1`, `3:4`, `4:5`, `5:4`, `9:16`, `9:21`. Default: `16:9`. ### Resolution * `resolution`: Optional. Accepted values: `720p`, `1080p`. Default: `1080p`. ### Seed * `seed`: Optional. Set the generation seed. Integer from `0` to `2147483647`. ### Safety Checker * `enable_safety_checker`: Optional. Control safety checking. Use `true` or `false`. ## Pricing Usage equals output seconds multiplied by the selected resolution rate. See [Pricing](https://vidgo.ai/apis/api-pricing) for current rates. Credits are deducted on submission and refunded if the task fails. ## OpenAPI ````yaml api-manual/video-series/alibaba-happyhorse-1-1-text-to-video.json POST /api/generate/submit openapi: 3.0.0 info: title: Vidgo API - Happy Horse 1.1 Text to Video description: Happy Horse 1.1 Text to Video through the Vidgo unified submit API. version: 1.0.0 servers: - url: https://api.vidgo.ai security: - BearerAuth: [] paths: /api/generate/submit: post: tags: - Video Series summary: Happy Horse 1.1 Text to Video description: >- Send only the fields shown for this workflow. Parameters from other workflows are rejected before credits are deducted. Prompts are trimmed and limited to 2,500 Unicode characters. Text-to-video and reference-to-video require a nonblank prompt. Image-to-video accepts an omitted, null, empty, or whitespace-only prompt. Image arrays accept public HTTP(S) URLs, image Data URIs, or raw Base64; conversion completes before credits are deducted. Choose an integer duration from three to fifteen seconds (default five) and 720p or 1080p resolution (default 1080p). Usage equals requested output seconds multiplied by the selected resolution rate. See [Pricing](https://vidgo.ai/apis/api-pricing) for current rates. Supported aspect ratios: 21:9, 16:9, 4:3, 1:1, 3:4, 4:5, 5:4, 9:16, and 9:21. Default: 16:9. `duration` and `seed` also accept integer strings such as `"5"`; decimal numbers such as `5.0` and decimal strings such as `"5.0"` are rejected. Null or empty values use the default duration or omit the seed. Supported boolean fields also accept `0`/`1` and case-insensitive strings `true`/`false`, `1`/`0`, `yes`/`no`, `y`/`n`, and `on`/`off`; null omits the field. Surrounding whitespace is trimmed, and resolution values are case-insensitive. operationId: submit_alibaba_happyhorse_1_1_text_to_video requestBody: required: true content: application/json: schema: type: object required: - model - input additionalProperties: true description: >- Keep model and callback_url at the root. Unknown root fields are ignored; unsupported input fields are rejected. properties: model: type: string enum: - alibaba/happyhorse-1.1/text-to-video example: alibaba/happyhorse-1.1/text-to-video description: >- Vidgo public model ID. Must be `alibaba/happyhorse-1.1/text-to-video`. input: type: object properties: prompt: type: string maxLength: 2500 minLength: 1 description: >- Trim surrounding whitespace. Maximum 2,500 Unicode characters. Required for text-to-video and reference-to-video; optional for image-to-video. aspect_ratio: type: string enum: - '21:9' - '16:9' - '4:3' - '1:1' - '3:4' - '4:5' - '5:4' - '9:16' - '9:21' default: '16:9' description: >- Output aspect ratio for text-to-video and reference-to-video resolution: type: string enum: - 720p - 1080p default: 1080p description: Output resolution duration: type: integer minimum: 3 maximum: 15 default: 5 description: >- Output duration in seconds. Credits are calculated by duration and selected resolution. seed: type: integer minimum: 0 maximum: 2147483647 description: Optional random seed for reproducible generation enable_safety_checker: type: boolean description: Enable content moderation for input and output additionalProperties: false required: - prompt callback_url: type: string nullable: true description: >- Optional public HTTP(S) endpoint for task completion notifications. HTTPS is recommended. Omit, use null, or use an empty string to disable callbacks. examples: basic: summary: Basic workflow value: model: alibaba/happyhorse-1.1/text-to-video input: prompt: >- A quiet forest under soft morning light, with natural detail. aspect_ratio: '16:9' resolution: 1080p duration: 5 callback: summary: Receive a completion callback value: model: alibaba/happyhorse-1.1/text-to-video input: prompt: >- A quiet forest under soft morning light, with natural detail. aspect_ratio: '16:9' resolution: 1080p duration: 5 callback_url: https://your-domain.com/callback responses: '200': description: Task submitted content: application/json: schema: type: object required: - code - data properties: code: type: integer enum: - 200 data: type: object required: - task_id - status - created_time properties: task_id: type: string status: type: string enum: - not_started - running - finished - failed created_time: type: string format: date-time example: code: 200 data: task_id: task-unified-example status: running created_time: '2026-09-10T08:00:00' '400': description: >- Invalid input, unsupported tier, inaccessible media, or insufficient credits content: application/json: schema: type: object required: - detail properties: detail: oneOf: - type: string - type: object additionalProperties: true - type: array items: {} '401': description: Invalid credentials content: application/json: schema: type: object required: - detail properties: detail: oneOf: - type: string - type: object additionalProperties: true - type: array items: {} '403': description: Access denied content: application/json: schema: type: object required: - detail properties: detail: oneOf: - type: string - type: object additionalProperties: true - type: array items: {} '404': description: Unknown or disabled model content: application/json: schema: type: object required: - detail properties: detail: oneOf: - type: string - type: object additionalProperties: true - type: array items: {} '408': description: Request timed out content: text/plain: schema: type: string example: Request timeout '422': description: Invalid JSON or non-object request body content: application/json: schema: type: object required: - detail properties: detail: oneOf: - type: string - type: object additionalProperties: true - type: array items: {} '429': description: Rate or API key credit limit exceeded content: application/json: schema: type: object required: - detail properties: detail: oneOf: - type: string - type: object additionalProperties: true - type: array items: {} '500': description: Internal error content: application/json: schema: type: object required: - detail properties: detail: oneOf: - type: string - type: object additionalProperties: true - type: array items: {} '502': description: Unable to create the upstream generation task content: application/json: schema: type: object required: - detail properties: detail: oneOf: - type: string - type: object additionalProperties: true - type: array items: {} '503': description: Model configuration or capability is not approved content: application/json: schema: type: object required: - detail properties: detail: oneOf: - type: string - type: object additionalProperties: true - type: array items: {} components: securitySchemes: BearerAuth: type: http scheme: bearer description: Use VIDGO_API_KEY. ````