HappyHorse 1.0 R2V

HappyHorse 1.0 R2V generates videos from 1–3 reference images combined with a text prompt. Uses an asynchronous task interface — submit a task and poll until completion.

Key Capabilities

Reference-image-to-video — Use 1–3 images as visual references
Resolution — 720P / 1080P
Aspect ratio — 16:9, 9:16, 1:1, 4:3, 3:4
Duration — 3–15 seconds
Watermark control — Optionally disable the bottom-right watermark

Workflow

POST /v1/video/generations  →  task_id
GET  /v1/video/generations/{task_id}  →  Poll until SUCCESS / FAILURE
Read data.result_url  (valid for 24 hours)

Quick Example

curl https://ai.cubeuaeai.com/v1/video/generations \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "model": "happyhorse-1.0-r2v",
    "prompt": "A woman in a red qipao gently raises her hand and opens a folding fan",
    "images": [
      "https://example.com/ref1.jpg",
      "https://example.com/ref2.jpg",
      "https://example.com/ref3.jpg"
    ],
    "parameters": {
      "resolution": "720P",
      "ratio": "16:9",
      "duration": 5,
      "watermark": false
    }
  }'

import requests, time

headers = {"Authorization": "Bearer YOUR_API_KEY"}

resp = requests.post(
    "https://ai.cubeuaeai.com/v1/video/generations",
    headers=headers,
    json={
        "model": "happyhorse-1.0-r2v",
        "prompt": "A woman in a red qipao gently raises her hand and opens a folding fan",
        "images": [
            "https://example.com/ref1.jpg",
            "https://example.com/ref2.jpg",
            "https://example.com/ref3.jpg",
        ],
        "parameters": {
            "resolution": "720P",
            "ratio": "16:9",
            "duration": 5,
            "watermark": False,
        }
    }
)
task_id = resp.json()["task_id"]

Parameters

Parameter	Type	Required	Description
`model`	string	Yes	Must be `happyhorse-1.0-r2v`
`prompt`	string	Yes	Video description text
`images`	string[]	Yes	1–3 reference image URLs
`resolution`	string	No	`720P` / `1080P`, default `1080P`
`ratio`	string	No	`16:9`, `9:16`, `1:1`, `4:3`, `3:4`, default `16:9`
`duration`	integer	No	Video duration 3–15 seconds, default `5`
`watermark`	boolean	No	Default `true`, set to `false` to disable watermark
`seed`	integer	No	Random seed `[0, 2147483647]`

Billing

Billed by resolution tier × user-requested duration. The pre-charged amount is the final amount. Failed tasks are automatically refunded.

API Reference

HappyHorse 1.0 R2V interactive Playground.

Task Query

Poll task status and retrieve the final video URL.

Quick Start

Models

Resources

HappyHorse 1.0 R2V

Key Capabilities

Workflow

Quick Example

Parameters

Billing

API Reference

Task Query

​Key Capabilities

​Workflow

​Quick Example

​Parameters

​Billing

API Reference

Task Query

Key Capabilities

Workflow

Quick Example

Parameters

Billing