HappyHorse 1.1 R2V

curl --request POST \ --url https://api.modellix.ai/api/v1/alibaba/happyhorse-1.1-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 images. Required. Use [Image 1], [Image 2], etc. to reference images in the reference_images array. Supports any language input. Maximum length: 5000 non-Chinese characters or 2500 Chinese characters (automatically truncated if exceeded).

Required string length: 1 - 5000

Examples:

"[Image 1] character walks through a neon-lit city street"

"[Image 1] character picks up the object from [Image 2] in a cinematic scene"

reference_images

string<uri>[]

required

Array of reference image URLs. Supports 1-9 images. Images can be referenced in the prompt by position, such as [Image 1], [Image 2], following array order. Image requirements: JPEG/JPG/PNG/WEBP, short edge >= 400 pixels, 720P+ recommended, file size <= 20MB 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