> ## 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-i2v

> API usage guide for happyhorse-1.1-i2v.

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

{/* source_updated_at: 1782503062 */}

**Model ID**

```bash theme={null}
happyhorse-1.1-i2v
```

**Calling method:** async

# happyhorse-1.1-i2v API Usage Guide

## Overview

**happyhorse-1.1-i2v** animates a first-frame image into a video guided by a text prompt. HappyHorse 1.1 delivers improved motion dynamics, facial texture quality, and native audio-video co-generation over 1.0.

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-i2v", "payload": {"prompt": "Slow cinematic pan, wind moving through the hair", "first_frame": "https://example.com/portrait.jpg", "resolution": "1080P", "duration": 5, "watermark": false}}'
```

## Request Parameters

| Parameter        | Type      | Required | Description                           |
| ---------------- | --------- | -------- | ------------------------------------- |
| first\_frame     | image URL | Yes      | Starting frame image                  |
| prompt           | string    | No       | Text prompt guiding motion/styling    |
| 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)        |
| 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-i2v",
  "status": "queued"
}
```