HappyHorse 1.0 R2V

curl --request POST \ --url https://api.modellix.ai/api/v1/alibaba/happyhorse-1.0-r2v \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data ' { "reference_images": [ "https://example.com/girl.jpg" ], "prompt": "A woman character1 wearing a red qipao, the camera moves smoothly" } '

{ "code": 0, "message": "success", "data": { "status": "pending", "task_id": "task-abc123", "model_id": "model-123", "get_result": { "method": "GET", "url": "https://api.modellix.ai/api/v1/tasks/task-abc123" } } }

Authorizations

Authorization

string

header

required

API Key authentication. Format: Bearer YOUR_API_KEY.

Body

application/json

prompt

string

required

Text prompt describing the scene and referencing characters. Required. Use character1, character2, character3, etc. to reference images in the reference_images array (first image = character1, second = character2, etc.). Supports any language input. Maximum length: 5000 non-Chinese characters or 2500 Chinese characters (automatically truncated if exceeded)

Required string length: 1 - 5000

Examples:

"A woman character1 wearing a red qipao, camera moves smoothly"

"Character1 interacts with object character2 in the scene"

reference_images

string<uri>[]

required

Array of reference image URLs. Supports 1-9 images. Images are referenced in the prompt using character1, character2, etc., following array order. Image requirements: Format: JPEG, JPG, PNG, WEBP; Resolution: Short edge >= 400 pixels (720P+ recommended); File size: <= 10MB per image. Supports HTTP/HTTPS URLs

Required array length: 1 - 9 elements

Pattern: ^https?://

resolution

enum<string>

default:1080P

Video resolution level. The model automatically scales to the nearest total pixels based on the selected resolution

Available options:

720P,

1080P

ratio

enum<string>

default:16:9

Video aspect ratio. Determines the output video dimensions

Available options:

16:9,

9:16,

1:1,

4:3,

3:4,

4:5,

5:4,

9:21,

21:9

duration

enum<integer>

default:5

Video duration in seconds. Must be an integer between 3 and 15

Available options:

3,

4,

5,

6,

7,

8,

9,

10,

11,

12,

13,

14,

15

Required range: 3 <= x <= 15

seed

integer

Random seed for reproducibility. If not specified, the system generates a random seed. Note: Due to the probabilistic nature of model generation, even with the same seed, results may not be completely identical

Required range: 0 <= x <= 2147483647

Response

200 - application/json

Task submitted successfully

code

integer

required

Response code, 0 indicates success

Example:

0

message

string

required

Response message

Example:

"success"

data

object

required

Detailed data about the submitted asynchronous task.

Show child attributes

Model API

Common API

File API

HappyHorse 1.0 R2V

Authorizations

Body

Response