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

> API usage guide for happyhorse-1.0-i2v.

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

{/* source_updated_at: 1776980621 */}

**Model ID**

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

**Calling method:** async

# happyhorse1.0-i2v API Usage Guide

## Overview

**happyhorse1.0-i2v** converts images into videos with improved visual fidelity, temporal consistency, and flexible media inputs. It supports first frame, last frame, driving audio, and first clip as media references, with continuous duration from 2 to 15 seconds.

Requests are submitted to the request-queue API and results are retrieved via polling.

## Authentication

All API requests require authentication using an API key. Include your API key in the Authorization header:

```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\": \"happyhorse1.0-i2v\", \"payload\": {\"prompt\": \"Slow cinematic pan around a futuristic tower at sunset with neon accents\", \"first_frame\": \"https://example.com/start-frame.jpg\", \"last_frame\": \"https://example.com/end-frame.jpg\", \"negative_prompt\": \"blurry, low quality, distorted\", \"resolution\": \"1080P\", \"duration\": 10, \"prompt_extend\": true, \"watermark\": false, \"seed\": 987654321}}"
```

## Request Parameters

| Parameter        | Type      | Required | Description                        |
| ---------------- | --------- | -------- | ---------------------------------- |
| prompt           | string    | No       | Text prompt guiding motion/styling |
| negative\_prompt | string    | No       | What to avoid in the video         |
| first\_frame     | image URL | No       | Starting frame                     |
| last\_frame      | image URL | No       | Ending frame                       |
| resolution       | enum      | No       | 720P or 1080P                      |
| duration         | int       | No       | 2–15 seconds                       |
| seed             | int       | No       | Reproducibility seed               |

## Response

```json theme={null}
{
 "request_id": "550e8400-e29b-41d4-a716-446655440000",
 "model": "happyhorse1.0-i2v",
 "status": "queued"
}
```