# Minimax Image To Video

Animate an image through Hermes Web UI using the MiniMax image-to-video API.

- Repository: https://github.com/EKKOLearnAI/ekko-studio (11634 stars)
- Category: Design
- License: MIT
- Last updated: 2026-11-01
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add EKKOLearnAI/ekko-studio --skill minimax-image-to-video -g -a claude-code -y`
Codex: `npx skills add EKKOLearnAI/ekko-studio --skill minimax-image-to-video -g -a codex -y`
Cursor: `npx skills add EKKOLearnAI/ekko-studio --skill minimax-image-to-video -g -a cursor -y`
Gemini CLI: `npx skills add EKKOLearnAI/ekko-studio --skill minimax-image-to-video -g -a gemini-cli -y`

## Description

Animate an image through Hermes Web UI using the MiniMax image-to-video API.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# MiniMax Image To Video

Use this skill when the user wants to animate an image with MiniMax.

If the Hermes Web UI endpoint returns an authentication, connection, or generation error, stop and report that error to the user.

## Workflow

Call the local Hermes Web UI media endpoint. The server resolves the selected profile's MiniMax API key, creates an image-to-video task through the official v1 API, polls it, downloads the finished mp4, and optionally saves it to a requested path.

Endpoint:

```bash
POST <Hermes Web UI base URL>/api/studio/media/minimax-image-to-video
```

Resolve the Hermes Web UI base URL in this order:

1. `HERMES_WEB_UI_URL`, if set.
2. `http://127.0.0.1:${PORT}`, if `PORT` is set.
3. `http://127.0.0.1:8648`.

Use `http://127.0.0.1:8647` for the development API backend and `http://127.0.0.1:6060` for the default Docker Compose external URL.

Always send the Hermes Web UI server bearer token. Resolve it in this order:

1. `AUTH_TOKEN`, if set.
2. `${HERMES_WEB_UI_HOME}/.token`, if `HERMES_WEB_UI_HOME` is set.
3. `${HERMES_WEBUI_STATE_DIR}/.token`, if `HERMES_WEBUI_STATE_DIR` is set.
4. `~/.hermes-web-ui/.token`.

If the run instructions include `[Current Hermes profile: <name>]`, send the exact profile in `X-Hermes-Profile`. If no profile is provided, omit that header.

Required JSON fields:

- One image input: `image_url`, `image_base64` with `mime_type`, or `image_path`.

Optional JSON fields:

The rest: https://github.com/EKKOLearnAI/ekko-studio/blob/HEAD/packages/skills/minimax-image-to-video/SKILL.md