Skip to main content
POST
/
happyhorse
/
api
/
v1
/
services
/
aigc
/
video-generation
/
reference-to-video
cURL
curl --request POST \
  --url https://api.ttapi.io/happyhorse/api/v1/services/aigc/video-generation/reference-to-video \
  --header 'Content-Type: application/json' \
  --header 'TT-API-KEY: <api-key>' \
  --data '
{
  "model": "happyhorse-1.0-r2v",
  "input": {
    "prompt": "<string>",
    "media": [
      {
        "type": "reference_image",
        "url": "<string>"
      }
    ]
  },
  "parameters": {
    "resolution": "720P",
    "ratio": "16:9",
    "duration": 5,
    "watermark": false,
    "seed": 12345
  }
}
'
{
  "output": {
    "task_status": "PENDING",
    "task_id": "0385dc79-5ff8-4d82-bcb6-xxxxxx"
  },
  "request_id": "4909100c-7b5a-9f92-bfe5-xxxxxx"
}

Documentation Index

Fetch the complete documentation index at: https://docs.ttapi.io/llms.txt

Use this file to discover all available pages before exploring further.

This is the HappyHorse Video API reference-to-video interface, generating videos based on multiple reference images.

Authorizations

​
TT-API-KEY
string
header
required

Please go to TTAPI Console to get the API key.

Body

application/json
​
model
string
default:happyhorse-1.0-r2v
required

Model name. Fixed value: happyhorse-1.0-r2v.

Example:

"happyhorse-1.0-r2v"

​
input
object
required

Basic input information, including reference images and prompt.

​
parameters
object

Video generation parameters, such as setting video resolution, aspect ratio, duration, etc.

Response

Success response

​
output
object
required

Task output information

​
request_id
string
required

Request unique identifier. Can be used for request tracing and troubleshooting.

Example:

"4909100c-7b5a-9f92-bfe5-xxxxxx"

Last modified on April 29, 2026