Skip to main content
Model ID 
happyhorse-1.1-r2v
Calling method: async

​
happyhorse-1.1-r2v API Usage Guide

​
Overview

happyhorse-1.1-r2v generates videos from multiple reference images and a text prompt. HappyHorse 1.1 significantly improves multi-character reference consistency: subjects from different images can be freely combined without cross-contamination, and storyboard / 3x3 grid references are faithfully preserved. Requests are submitted to the request-queue API and results are retrieved via polling.

​
Authentication

Authorization: Bearer YOUR_API_KEY

​
Submit Video Generation Request

​
Base URL

https://console.gmicloud.ai

​
Endpoint

POST /api/v1/ie/requestqueue/apikey/requests

​
Request Format

curl -X POST "https://console.gmicloud.ai/api/v1/ie/requestqueue/apikey/requests" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "happyhorse-1.1-r2v", "payload": {"prompt": "Two characters walk through a sunlit forest path, wide shot", "reference_image": ["https://example.com/char-a.jpg", "https://example.com/char-b.jpg"], "resolution": "1080P", "duration": 5, "watermark": false}}'

​
Request Parameters

ParameterTypeRequiredDescription
promptstringYesText prompt describing the scene and motion (max 1500 chars)
reference_imageimage URL / arrayYes1–5 reference images for appearance guidance
negative_promptstringNoWhat to avoid in the video
resolutionenumNo720P or 1080P (affects pricing)
durationintNo3–15 seconds (affects pricing)
prompt_extendbooleanNoEnable LLM prompt rewriting
audiobooleanNoEnable native audio generation
watermarkbooleanNoAdd AI Generated watermark
seedintNoReproducibility seed [0, 2147483647]

​
Response

{
  "request_id": "550e8400-e29b-41d4-a716-446655440000",
  "model": "happyhorse-1.1-r2v",
  "status": "queued"
}