# Flux 3 Image To Video

> AI model for generating video content

## Overview

- **Model ID**: `flux-3-i2v`
- **Category**: video
- **Provider**: bfl
- **Source Type**: Closed Source Model
- **Status**: model_ready
- **Screenshot**: `https://assets.modelslab.ai/generations/f36b1da2-76b6-4195-9f70-fb4157e16280.webp`

## API Information

This model can be used via our HTTP API. See the API documentation and usage examples below.

### Endpoint

- **URL**: `https://modelslab.com/api/v7/video-fusion/image-to-video`
- **Method**: POST

### Parameters

- **`init_image`** (required): Upload upto 9 reference image
  - Type: array

- **`prompt`** (required): Text description of the video you want to generate
  - Type: textarea
  - Example: Enter prompt for video

- **`aspect_ratio`** (required): 
  - Type: select (options: 21:9, 16:9, 4:3, 1:1, 3:4, 9:16)

- **`resolution`** (required): 
  - Type: select (options: HD, FHD)

- **`duration`** (required): Choose the duration between 5-20 seconds
  - Type: number (range: 5-20)

## Usage Examples

### cURL

```bash
curl --request POST \
  --url https://modelslab.com/api/v7/video-fusion/image-to-video \
  --header "Content-Type: application/json" \
  --data '{
    "key": "YOUR_API_KEY",
    "model_id": "flux-3-i2v",
    "prompt": "In a frozen, ancient Nordic valley, the shamanic warrior—cloaked in fur, wearing a skull mask with curled horns—stands at the edge of a glacier lake. The wind howls violently, whipping up snow around him as he slams his staff into the icy ground, causing the earth to tremble. Blue runes glow across his mask as magic awakens. ",
    "aspect_ratio": "21:9",
    "resolution": "hd",
    "duration": "5"
  }'
```

### Python

```python
import requests

response = requests.post(
    "https://modelslab.com/api/v7/video-fusion/image-to-video",
    headers={
        "Content-Type": "application/json"
    },
    json={
        "key": "YOUR_API_KEY",
        "model_id": "flux-3-i2v",
        "prompt": "In a frozen, ancient Nordic valley, the shamanic warrior—cloaked in fur, wearing a skull mask with curled horns—stands at the edge of a glacier lake. The wind howls violently, whipping up snow around him as he slams his staff into the icy ground, causing the earth to tremble. Blue runes glow across his mask as magic awakens. ",
        "aspect_ratio": "21:9",
        "resolution": "hd",
        "duration": "5"
    }
)

print(response.json())
```

### JavaScript

```javascript
fetch("https://modelslab.com/api/v7/video-fusion/image-to-video", {
  method: "POST",
  headers: {
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "key": "YOUR_API_KEY",
    "model_id": "flux-3-i2v",
    "prompt": "In a frozen, ancient Nordic valley, the shamanic warrior—cloaked in fur, wearing a skull mask with curled horns—stands at the edge of a glacier lake. The wind howls violently, whipping up snow around him as he slams his staff into the icy ground, causing the earth to tremble. Blue runes glow across his mask as magic awakens. ",
    "aspect_ratio": "21:9",
    "resolution": "hd",
    "duration": "5"
  })
})
.then(response => response.json())
.then(data => console.log(data));
```

## Integration Options

### CLI

Install: `curl -fsSL https://modelslab.sh/install.sh | sh` or `brew install modelslab/tap/modelslab`

```bash
modelslab auth login                                    # Authenticate
modelslab models search "flux-3-i2v"                       # Find this model
modelslab models detail --id flux-3-i2v                    # Get model details
modelslab generate image --prompt "..." --model flux-3-i2v  # Generate with model
modelslab config set generation.default_model flux-3-i2v   # Set as default
```

- Website: https://modelslab.sh
- GitHub: https://github.com/ModelsLab/modelslab-cli

### MCP Servers (Model Context Protocol)

For Claude Code, Cursor, VS Code, Windsurf, and any MCP-compatible agent.

- Generation: `https://modelslab.com/mcp/v7` (API key auth, 23 tools)
- Agent Control Plane: `https://modelslab.com/mcp/agents` (Bearer token auth, 10 tools)

Claude Code config (`~/.claude/settings.json`):

```json
{
  "mcpServers": {
    "modelslab-v7": {
      "url": "https://modelslab.com/mcp/v7",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}
```

- Documentation: https://docs.modelslab.com/mcp-web-api/overview

### Agent Skills

Install skill files directly into AI coding agents:

```bash
npx skills add modelslab/skills --all                          # All skills
npx skills add modelslab/skills --skill image-generation       # Specific skill
npx skills add modelslab/skills --all -a claude-code -a cursor # Target agents
```

- GitHub: https://github.com/ModelsLab/skills
- Documentation: https://docs.modelslab.com/agent-skills

### SDKs

- Python: `pip install modelslab`
- TypeScript: `npm install modelslab`
- PHP: `composer require modelslab/modelslab`
- Go: `go get github.com/modelslab/modelslab-go`
- Dart: `dart pub add modelslab`

## Links

- [Model Playground](https://modelslab.com/models/bfl/flux-3-i2v)
- [API Documentation](https://docs.modelslab.com)
- [ModelsLab Platform](https://modelslab.com)