{"servers":[{"url":"https://api.modellix.ai/api/v1/alibaba/happyhorse-1.1-r2v"}],"post":{"description":"[Core Function] HappyHorse 1.1 R2V is Alibaba's latest reference-image-to-video model. [Strengths] It uses 1-9 reference images to preserve subject or character appearance while generating new video actions, supports 720P/1080P output, 3-15 second duration, and expanded aspect ratios including 4:5, 5:4, 9:21, and 21:9. [Best For] Highly recommended for: character-consistent storytelling, reference-based product shots, and multi-image subject composition. [Limitations] Do NOT use if the user simply wants to animate a single image exactly as provided; use HappyHorse I2V instead. [Routing] Use when the user provides one or more reference images and asks for a newly generated HappyHorse video.","operationId":"happyhorse11R2vAsync","requestBody":{"content":{"application/json":{"examples":{"advanced":{"summary":"Advanced with all parameters","value":{"duration":10,"prompt":"Character1 interacts with object character2 and character3 in a cinematic scene","ratio":"16:9","reference_images":["https://example.com/person.jpg","https://example.com/object1.jpg","https://example.com/object2.jpg"],"resolution":"1080P","seed":12345}},"image_reference_prompt":{"summary":"Prompt using image references","value":{"duration":5,"prompt":"[Image 1] character gracefully opens the folding fan from [Image 2] in a cinematic close-up","ratio":"21:9","reference_images":["https://example.com/girl.jpg","https://example.com/fan.jpg"],"resolution":"1080P"}},"maximum_images":{"summary":"Maximum 9 reference images","value":{"duration":15,"prompt":"A complex scene featuring character1 through character9 interacting together","ratio":"16:9","reference_images":["https://example.com/img1.jpg","https://example.com/img2.jpg","https://example.com/img3.jpg","https://example.com/img4.jpg","https://example.com/img5.jpg","https://example.com/img6.jpg","https://example.com/img7.jpg","https://example.com/img8.jpg","https://example.com/img9.jpg"],"resolution":"720P"}},"multiple_images":{"summary":"Multiple reference images with character references","value":{"duration":5,"prompt":"A woman character1 in a red qipao, gracefully opens a folding fan character2 as her tassel earrings character3 sway with head movement","ratio":"16:9","reference_images":["https://example.com/girl.jpg","https://example.com/fan.jpg","https://example.com/earrings.jpg"],"resolution":"1080P"}},"single_image":{"summary":"Single reference image","value":{"prompt":"A woman character1 wearing a red qipao, the camera moves smoothly","reference_images":["https://example.com/girl.jpg"]}},"vertical_video":{"summary":"Vertical video format (9:16)","value":{"duration":5,"prompt":"Character1 gracefully turns in front of the camera","ratio":"9:16","reference_images":["https://example.com/portrait.jpg"],"resolution":"1080P"}}},"schema":{"properties":{"duration":{"default":5,"description":"Video duration in seconds. Must be an integer between 3 and 15","enum":[3,4,5,6,7,8,9,10,11,12,13,14,15],"maximum":15,"minimum":3,"type":"integer"},"prompt":{"description":"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).","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"],"maxLength":5000,"minLength":1,"type":"string"},"ratio":{"default":"16:9","description":"Video aspect ratio. Determines the output video dimensions","enum":["16:9","9:16","1:1","4:3","3:4","4:5","5:4","9:21","21:9"],"type":"string"},"reference_images":{"description":"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.","items":{"examples":["https://example.com/image1.jpg","https://example.com/image2.png"],"format":"uri","pattern":"^https?://","type":"string"},"maxItems":9,"minItems":1,"type":"array"},"resolution":{"default":"1080P","description":"Video resolution level. The model automatically scales to the nearest total pixels based on the selected resolution","enum":["720P","1080P"],"type":"string"},"seed":{"description":"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","maximum":2147483647,"minimum":0,"type":"integer"}},"required":["reference_images","prompt"],"type":"object"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"properties":{"code":{"description":"Response code, 0 indicates success","example":0,"type":"integer"},"data":{"description":"Detailed data about the submitted asynchronous task.","properties":{"get_result":{"description":"API information to query the task result","properties":{"method":{"description":"HTTP method","example":"GET","type":"string"},"url":{"description":"Full URL to query the task result","example":"https://api.modellix.ai/api/v1/tasks/task-abc123","type":"string"}},"type":"object"},"model_id":{"description":"Model ID","example":"model-123","type":"string"},"status":{"description":"Task status","enum":["pending","processing"],"example":"pending","type":"string"},"task_id":{"description":"Unique task identifier","example":"task-abc123","type":"string"}},"required":["status","task_id","model_id"],"type":"object"},"message":{"description":"Response message","example":"success","type":"string"}},"required":["code","message","data"],"type":"object"}}},"description":"Task submitted successfully"}},"summary":"HappyHorse 1.1 R2V","x-mint":{"href":"alibaba/happyhorse-1-1-r2v"}}}