{"servers":[{"url":"https://api.modellix.ai/api/v1/alibaba/happyhorse-1.0-r2v"}],"post":{"description":"[Core Function] HappyHorse 1.0 R2V is a reference-to-video model. [Strengths] It excels at maintaining character consistency using up to 9 reference images while generating new video actions based on a prompt. [Best For] Highly recommended for: character-consistent storytelling and generating multiple scenes with the same subject. [Limitations] Do NOT use if you simply want to animate a single image exactly as it is (use HappyHorse I2V instead). [Routing] Use this when the user provides reference images to dictate character/subject appearance in a newly generated action.","operationId":"happyhorse10R2vAsync","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}},"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 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)","examples":["A woman character1 wearing a red qipao, camera moves smoothly","Character1 interacts with object character2 in the 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 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","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.0 R2V","x-mint":{"href":"alibaba/happyhorse-1-0-r2v"}}}