> ## Documentation Index
> Fetch the complete documentation index at: https://docs.gmicloud.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# happyhorse-1.1-r2v

> API usage guide for happyhorse-1.1-r2v.

{/* source_model_id: happyhorse-1.1-r2v */}

{/* source_updated_at: 1782503051 */}

**Model ID**

```bash theme={null}
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

```bash theme={null}
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

```bash theme={null}
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

| Parameter        | Type              | Required | Description                                                  |
| ---------------- | ----------------- | -------- | ------------------------------------------------------------ |
| prompt           | string            | Yes      | Text prompt describing the scene and motion (max 1500 chars) |
| reference\_image | image URL / array | Yes      | 1–5 reference images for appearance guidance                 |
| negative\_prompt | string            | No       | What to avoid in the video                                   |
| resolution       | enum              | No       | 720P or 1080P (affects pricing)                              |
| duration         | int               | No       | 3–15 seconds (affects pricing)                               |
| prompt\_extend   | boolean           | No       | Enable LLM prompt rewriting                                  |
| audio            | boolean           | No       | Enable native audio generation                               |
| watermark        | boolean           | No       | Add AI Generated watermark                                   |
| seed             | int               | No       | Reproducibility seed \[0, 2147483647]                        |

## Response

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