minimax/h3-developer/image-to-video

Imagen a Video

DEV

MiniMax H3 Developer Image-to-Video API by MiniMax

minimax/h3-developer/image-to-video

Image-to-video

MiniMax H3-Developer self-hosted image-to-video: animate a first-frame image (optionally a last frame) driven by a text prompt, with generated audio. Supports 480P/768P/2K.

Comparar modelos

MiniMax H3 Developer Image-to-Video ha sido desarrollado por MiniMax. Atlas Cloud (operado por Atlas Cloud AI LLC) proporciona acceso al modelo, pero no es su propietario. Todas las marcas comerciales pertenecen a sus respectivos titulares.

Entrada

Prompt *

Imagen

Arrastra archivos aquí o haz clic para subir

MAX:1

Imagen final

Arrastra archivos aquí o haz clic para subir

MAX:1

Resolución *

Duración *

Relación de aspecto

Prompt expansion

Salida

Inactivo

Los videos generados se mostrarán aquí

Configura los parámetros y haz clic en ejecutar para comenzar a generar

Cada ejecución costará $0.015. Con $10 puedes ejecutar aproximadamente 666 veces.

Puedes continuar con:

Seedance 2.0 Kling v3 Vidu Wan2.7

Parámetros

Ejemplo de código
import requests
import time

# Step 1: Start video generation
generate_url = "https://api.atlascloud.ai/api/v1/model/generateVideo"
headers = {
    "Content-Type": "application/json",
    "Authorization": "Bearer $ATLASCLOUD_API_KEY"
}
data = {
    "model": "minimax/h3-developer/image-to-video",  # Required. model name
    "prompt": "A beautiful sunset over the ocean with gentle waves",  # Required. The text prompt describing the motion / action for the video
    "image": "example_value",  # First frame of the video
    "end_image": "example_value",  # Optional last frame of the video
    "resolution": "768P",  # Required. The resolution of the generated video. options: 480P | 768P | 1440p-sr | 4k-sr
    "duration": 8,  # Required. The duration of the generated video in seconds
    "ratio": "adaptive",  # The aspect ratio of the generated video. options: adaptive
    "prompt_expansion": False,  # Whether to expand the prompt for better results
}

generate_response = requests.post(generate_url, headers=headers, json=data)
generate_result = generate_response.json()
prediction_id = generate_result["data"]["id"]

# Step 2: Poll for result
poll_url = f"https://api.atlascloud.ai/api/v1/model/prediction/{prediction_id}"

def check_status():
    while True:
        response = requests.get(poll_url, headers={"Authorization": "Bearer $ATLASCLOUD_API_KEY"})
        result = response.json()

        if result["data"]["status"] in ["completed", "succeeded"]:
            print("Generated video:", result["data"]["outputs"][0])
            return result["data"]["outputs"][0]
        elif result["data"]["status"] == "failed":
            raise Exception(result["data"]["error"] or "Generation failed")
        else:
            # Still processing, wait 2 seconds
            time.sleep(2)

video_url = check_status()

Instalar

Instala el paquete de dependencias necesario.

pip install requests

Autenticación

Todas las solicitudes de API requieren autenticación mediante una clave de API. Puedes obtener tu clave de API desde el panel de Atlas Cloud.

export ATLASCLOUD_API_KEY="your-api-key-here"

Encabezados HTTP

import os

API_KEY = os.environ.get("ATLASCLOUD_API_KEY")
headers = {
    "Content-Type": "application/json",
    "Authorization": f"Bearer {API_KEY}"
}

Mantén tu clave de API segura

Nunca expongas tu clave de API en código del lado del cliente ni en repositorios públicos. Usa variables de entorno o un proxy de backend en su lugar.

Enviar una solicitud

import requests

url = "https://api.atlascloud.ai/api/v1/model/generateVideo"
headers = {
    "Content-Type": "application/json",
    "Authorization": "Bearer $ATLASCLOUD_API_KEY"
}
data = {
    "model": "your-model",
    "prompt": "A beautiful landscape"
}

response = requests.post(url, headers=headers, json=data)
print(response.json())

Enviar una solicitud

Envía una solicitud de generación asíncrona. La API devuelve un ID de predicción que puedes usar para verificar el estado y obtener el resultado.

POST/api/v1/model/generateVideo

Cuerpo de la solicitud

import requests

url = "https://api.atlascloud.ai/api/v1/model/generateVideo"
headers = {
    "Content-Type": "application/json",
    "Authorization": "Bearer $ATLASCLOUD_API_KEY"
}

data = {
    "model": "minimax/h3-developer/image-to-video",
    "prompt": "A beautiful sunset over the ocean with gentle waves"
}

response = requests.post(url, headers=headers, json=data)
result = response.json()

print(f"Prediction ID: {result['data']['id']}")
print(f"Status: {result['data']['status']}")

Respuesta

{
  "code": 200,
  "data": {
    "id": "pred_abc123",
    "status": "processing",
    "model": "model-name",
    "created_at": "2025-01-01T00:00:00Z"
  }
}

Verificar estado

Consulta el endpoint de predicción para verificar el estado actual de tu solicitud.

GET/api/v1/model/prediction/{prediction_id}

Ejemplo de polling

import requests
import time

prediction_id = "pred_abc123"
url = f"https://api.atlascloud.ai/api/v1/model/prediction/{prediction_id}"
headers = { "Authorization": "Bearer $ATLASCLOUD_API_KEY" }

while True:
    response = requests.get(url, headers=headers)
    result = response.json()
    status = result["data"]["status"]
    print(f"Status: {status}")

    if status in ["completed", "succeeded"]:
        output_url = result["data"]["outputs"][0]
        print(f"Output URL: {output_url}")
        break
    elif status == "failed":
        print(f"Error: {result['data'].get('error', 'Unknown')}")
        break

    time.sleep(3)

Valores de estado

processingLa solicitud aún se está procesando.

completedLa generación está completa. Las salidas están disponibles.

succeededLa generación fue exitosa. Las salidas están disponibles.

failedLa generación falló. Verifica el campo de error.

Respuesta completada

{
  "data": {
    "id": "pred_abc123",
    "status": "completed",
    "outputs": [
      "https://storage.atlascloud.ai/outputs/result.mp4"
    ],
    "metrics": {
      "predict_time": 45.2
    },
    "created_at": "2025-01-01T00:00:00Z",
    "completed_at": "2025-01-01T00:00:10Z"
  }
}

Subir archivos

Sube archivos al almacenamiento de Atlas Cloud y obtén una URL que puedes usar en tus solicitudes de API. Usa multipart/form-data para subir.

POST/api/v1/model/uploadMedia

Ejemplo de carga

import requests

url = "https://api.atlascloud.ai/api/v1/model/uploadMedia"
headers = { "Authorization": "Bearer $ATLASCLOUD_API_KEY" }

with open("image.png", "rb") as f:
    files = {"file": ("image.png", f, "image/png")}
    response = requests.post(url, headers=headers, files=files)

result = response.json()
download_url = result["data"]["download_url"]
print(f"File URL: {download_url}")

Respuesta

{
  "data": {
    "download_url": "https://storage.atlascloud.ai/uploads/abc123/image.png",
    "file_name": "image.png",
    "content_type": "image/png",
    "size": 1024000
  }
}

Schema de entrada

Los siguientes parámetros se aceptan en el cuerpo de la solicitud.

Total: 8Obligatorio: 4Opcional: 4

modelstringrequired

model name

Default: "minimax/h3-developer/image-to-video"

promptstringrequired

The text prompt describing the motion / action for the video.

imagestring

First frame of the video. Public URL or Base64. Formats: png, jpeg, jpg, webp.

end_imagestring

Optional last frame of the video. Public URL or Base64. Formats: png, jpeg, jpg, webp.

resolutionstringrequired

The resolution of the generated video.

Default: "768P"

480P768P1440p-sr4k-sr

durationnumberrequired

The duration of the generated video in seconds.

Default: 8

456789101112131415

ratiostring

The aspect ratio of the generated video. Use 'adaptive' to let the model choose.

Default: "adaptive"

adaptive

prompt_expansionboolean

Whether to expand the prompt for better results.

Default: false

Ejemplo de cuerpo de solicitud

{
  "model": "minimax/h3-developer/image-to-video",
  "prompt": "A beautiful landscape",
  "resolution": "768P",
  "duration": 8,
  "ratio": "adaptive",
  "prompt_expansion": false
}

Schema de salida

La API devuelve una respuesta de predicción con las URL de salida generadas.

created_atstring

ISO timestamp of when the request was created (e.g., “2023-04-01T12:34:56.789Z”).

idstring

Unique identifier for the prediction, the ID of the prediction to get.

modelstring

Model ID used for the prediction.

outputsarray

Array of URLs to the generated content (empty when status is not completed).

statusstring

Status of the task: created, processing, completed, or failed.

Ejemplo de respuesta

{
  "id": "pred_abc123",
  "status": "completed",
  "model": "model-name",
  "outputs": [
    "https://storage.atlascloud.ai/outputs/result.mp4"
  ],
  "metrics": {
    "predict_time": 45.2
  },
  "created_at": "2025-01-01T00:00:00Z",
  "completed_at": "2025-01-01T00:00:10Z"
}

Atlas Cloud Skills

Atlas Cloud Skills integra más de 400 modelos de IA directamente en tu asistente de codificación con IA. Un solo comando para instalar y luego usa lenguaje natural para generar imágenes, videos y chatear con LLM.

Clientes compatibles

Claude Code

OpenAI Codex

Gemini CLI

Cursor

Windsurf

VS Code

Trae

GitHub Copilot

Cline

Roo Code

Amp

Goose

Replit

40+ clientes compatibles

Instalar

npx skills add AtlasCloudAI/atlas-cloud-skills

Configurar clave de API

Obtén tu clave de API desde el panel de Atlas Cloud y configúrala como variable de entorno.

export ATLASCLOUD_API_KEY="your-api-key-here"

Funcionalidades

Una vez instalado, puedes usar lenguaje natural en tu asistente de IA para acceder a todos los modelos de Atlas Cloud.

Generación de imágenesGenera imágenes con modelos como Nano Banana 2, Z-Image y más.

Creación de videosCrea videos a partir de texto o imágenes con Kling, Vidu, Veo, etc.

Chat con LLMChatea con Qwen, DeepSeek y otros modelos de lenguaje de gran escala.

Carga de mediosSube archivos locales para flujos de trabajo de edición de imágenes e imagen a video.

Más información

github.com/AtlasCloudAI/atlas-cloud-skills

MCP Server

Atlas Cloud MCP Server conecta tu IDE con más de 400 modelos de IA a través del Model Context Protocol. Funciona con cualquier cliente compatible con MCP.

Clientes compatibles

Cursor

VS Code

Windsurf

Claude Code

OpenAI Codex

Gemini CLI

Cline

Roo Code

100+ clientes compatibles

Instalar

npx -y atlascloud-mcp

Configuración

Agrega la siguiente configuración al archivo de configuración de MCP de tu IDE.

{
  "mcpServers": {
    "atlascloud": {
      "command": "npx",
      "args": [
        "-y",
        "atlascloud-mcp"
      ],
      "env": {
        "ATLASCLOUD_API_KEY": "your-api-key-here"
      }
    }
  }
}

Herramientas disponibles

atlas_generate_imageGenera imágenes a partir de indicaciones de texto.

atlas_generate_videoCrea videos a partir de texto o imágenes.

atlas_chatChatea con modelos de lenguaje de gran escala.

atlas_list_modelsExplora más de 400 modelos de IA disponibles.

atlas_quick_generateCreación de contenido en un solo paso con selección automática de modelo.

atlas_upload_mediaSube archivos locales para flujos de trabajo de API.

Más información

github.com/AtlasCloudAI/mcp-server

API Schema

{
  "components": {
    "schemas": {
      "Input": {
        "properties": {
          "model": {
            "type": "string",
            "description": "model name",
            "default": "minimax/h3-developer/image-to-video"
          },
          "prompt": {
            "description": "The text prompt describing the motion / action for the video.",
            "type": "string"
          },
          "image": {
            "description": "First frame of the video. Public URL or Base64. Formats: png, jpeg, jpg, webp.",
            "type": "string",
            "x-ui-component": "uploaders"
          },
          "end_image": {
            "description": "Optional last frame of the video. Public URL or Base64. Formats: png, jpeg, jpg, webp.",
            "type": "string",
            "x-ui-component": "uploaders"
          },
          "resolution": {
            "default": "768P",
            "description": "The resolution of the generated video.",
            "enum": [
              "480P",
              "768P",
              "1440p-sr",
              "4k-sr"
            ],
            "type": "string",
            "x-ui-component": "select"
          },
          "duration": {
            "default": 8,
            "description": "The duration of the generated video in seconds.",
            "enum": [
              4,
              5,
              6,
              7,
              8,
              9,
              10,
              11,
              12,
              13,
              14,
              15
            ],
            "type": "number",
            "x-ui-component": "select"
          },
          "ratio": {
            "default": "adaptive",
            "description": "The aspect ratio of the generated video. Use 'adaptive' to let the model choose.",
            "enum": [
              "adaptive"
            ],
            "type": "string",
            "x-ui-component": "select"
          },
          "prompt_expansion": {
            "default": false,
            "description": "Whether to expand the prompt for better results.",
            "type": "boolean",
            "x-ui-component": "switch"
          }
        },
        "required": [
          "model",
          "prompt",
          "resolution",
          "duration"
        ],
        "type": "object",
        "x-order-properties": [
          "model",
          "prompt",
          "image",
          "end_image",
          "resolution",
          "duration",
          "ratio",
          "prompt_expansion"
        ]
      },
      "PredictionResponse": {
        "properties": {
          "created_at": {
            "description": "ISO timestamp of when the request was created (e.g., “2023-04-01T12:34:56.789Z”).",
            "format": "date-time",
            "type": "string"
          },
          "id": {
            "description": "Unique identifier for the prediction, the ID of the prediction to get.",
            "type": "string"
          },
          "model": {
            "description": "Model ID used for the prediction.",
            "type": "string"
          },
          "outputs": {
            "description": "Array of URLs to the generated content (empty when status is not completed).",
            "items": {
              "type": "string"
            },
            "type": "array"
          },
          "status": {
            "description": "Status of the task: created, processing, completed, or failed.",
            "type": "string"
          },
          "urls": {
            "description": "Object containing related API endpoints.",
            "type": "object"
          }
        },
        "type": "object"
      }
    },
    "securitySchemes": {
      "apiKeyAuth": {
        "in": "header",
        "name": "Authorization",
        "type": "apiKey"
      }
    }
  },
  "info": {
    "description": "The AtlasCloud API.",
    "title": "AtlasCloud API",
    "version": "1.0.0"
  },
  "openapi": "3.0.0",
  "paths": {
    "/api/v1/model/prediction/{request_id}": {
      "get": {
        "parameters": [
          {
            "in": "path",
            "name": "request_id",
            "required": true,
            "schema": {
              "description": "Request ID",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PredictionResponse"
                }
              }
            },
            "description": "Result of the request."
          }
        }
      },
      "x-api-name": "model_result"
    },
    "/api/v1/model/generateVideo": {
      "post": {
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/Input"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PredictionResponse"
                }
              }
            },
            "description": "The request status."
          }
        }
      },
      "x-api-name": "model_run"
    }
  },
  "servers": [
    {
      "url": "https://api.atlascloud.ai"
    }
  ]
}

Plantilla de Prompt Compatible con LLM

# minimax/h3-developer/image-to-video

> MiniMax H3-Developer self-hosted image-to-video: animate a first-frame image (optionally a last frame) driven by a text prompt, with generated audio. Supports 480P/768P/2K.


## Overview

- **Submit endpoint (POST)**: `https://api.atlascloud.ai/api/v1/model/generateVideo` — start an async generation; returns a `prediction_id`
- **Poll endpoint (GET)**: `https://api.atlascloud.ai/api/v1/model/prediction/{prediction_id}` — poll this until the prediction finishes
- **Model ID**: `minimax/h3-developer/image-to-video`


## API Information

This model can be used via our HTTP API or more conveniently via our client libraries.
See the input and output schema below, as well as the usage examples.


### Input Schema

The API accepts the following input parameters:

- **`model`** (`string`, _required_):
  model name
  - Default: `"minimax/h3-developer/image-to-video"`

- **`prompt`** (`string`, _required_):
  The text prompt describing the motion / action for the video.

- **`image`** (`string`, _optional_):
  First frame of the video. Public URL or Base64. Formats: png, jpeg, jpg, webp.

- **`end_image`** (`string`, _optional_):
  Optional last frame of the video. Public URL or Base64. Formats: png, jpeg, jpg, webp.

- **`resolution`** (`string`, _required_):
  The resolution of the generated video.
  - Default: `"768P"`
  - Options: "480P", "768P", "1440p-sr", "4k-sr"

- **`duration`** (`number`, _required_):
  The duration of the generated video in seconds.
  - Default: `8`
  - Options: 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15

- **`ratio`** (`string`, _optional_):
  The aspect ratio of the generated video. Use 'adaptive' to let the model choose.
  - Default: `"adaptive"`
  - Options: "adaptive"

- **`prompt_expansion`** (`boolean`, _optional_):
  Whether to expand the prompt for better results.
  - Default: `false`



**Required Parameters Example**:

```json
{
  "model": "minimax/h3-developer/image-to-video",
  "prompt": "",
  "resolution": "768P",
  "duration": 8
}
```


**Full Example**:

```json
{
  "model": "minimax/h3-developer/image-to-video",
  "prompt": "",
  "image": "",
  "end_image": "",
  "resolution": "768P",
  "duration": 8,
  "ratio": "adaptive",
  "prompt_expansion": false
}
```


### Output Schema

The API returns the following output format:


- **`created_at`** (`string`, _optional_):
  ISO timestamp of when the request was created (e.g., “2023-04-01T12:34:56.789Z”).

- **`id`** (`string`, _optional_):
  Unique identifier for the prediction, the ID of the prediction to get.

- **`model`** (`string`, _optional_):
  Model ID used for the prediction.

- **`outputs`** (`array[string]`, _optional_):
  Array of URLs to the generated content (empty when status is not completed).

- **`status`** (`string`, _optional_):
  Status of the task: created, processing, completed, or failed.

- **`urls`** (`object`, _optional_):
  Object containing related API endpoints.



**Example Response**:

```json
{
  "created_at": "",
  "id": "",
  "model": "",
  "outputs": [
    ""
  ],
  "status": "",
  "urls": {}
}
```


## Usage Examples

### cURL

```bash
# Step 1: Start generation (async)
curl -X POST "https://api.atlascloud.ai/api/v1/model/generateVideo" \
  -H "Authorization: Bearer $ATLASCLOUD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "minimax/h3-developer/image-to-video",
  "prompt": "",
  "image": "",
  "end_image": "",
  "resolution": "768P",
  "duration": 8,
  "ratio": "adaptive",
  "prompt_expansion": false
}'

# Response will contain: {"code": 200, "data": {"id": "prediction_id", "status": "processing"}}

# Step 2: Poll for result (replace {prediction_id} with the id returned above)
curl -X GET "https://api.atlascloud.ai/api/v1/model/prediction/{prediction_id}" \
  -H "Authorization: Bearer $ATLASCLOUD_API_KEY"

# Keep polling until status is "completed", "succeeded" or "failed"
# When completed, outputs will contain the generated content URL(s)
```

## Additional Resources

### Documentation

- [Model Playground](https://www.atlascloud.ai/models/minimax/h3-developer/image-to-video)

The race car speeds forward.

Cargando...

MiniMax H3-Developer Image-to-Video

MiniMax H3-Developer Image-to-Video brings a static image to life — with sound. Provide a first-frame image — and, optionally, a last frame — plus a prompt describing the motion. Generate native 480P or 768P video, or select an ESR tier to enhance the output to a 1080P, 1440P, or 4K short edge, complete with a synchronized soundtrack generated from the described scene.

Why Choose This?

Image-driven generation Animate any image with natural, controllable motion.
Native audio A matching soundtrack (ambient sound, effects, and music) is generated alongside the video — no separate audio input needed.
First & last frame control Set the opening frame, and optionally pin the closing frame for a precise transition.
Enhanced resolution output Generate native 480P or 768P video, or use ESR for a 1080P, 1440P, or 4K short edge.
Selectable duration Produce 5–15s clips.

Parameters

Parameter	Required	Description
prompt	No	Text description of the desired motion and action
image	Yes	First frame of the video (public URL)
end_image	No	Last frame of the video (public URL)
resolution	No	Video resolution. Available options: `768P` (default), `480P`, `1080p-esr`, `1440p-esr`, `4k-esr`. ESR tiers generate a native 768P source and enhance the output to the requested short edge.
duration	No	Duration of the generated video in seconds. Integer between 5 and 15 (default 5)
prompt_expansion	No	Enable AI prompt expansion via H3 Context-IR. When `true`, your prompt is first expanded into a rich, structured description (shot, soundscape, music) before generation, and an additional per-token Context-IR fee applies. Default `false`: the prompt is used as-is with no extra charge.

How to Use

Upload your first-frame image — the video will start from this image.
(Optional) Upload a last-frame image — the video will end on this image.
Write your prompt — describe the motion, camera movement, action, and the sound of the scene.
Set resolution and duration — balance quality against generation speed.
(Optional) Tune seed and steps — fix the seed for reproducibility, raise steps for quality.
Run — submit and download your video.

Best Use Cases

Photo Animation — Bring portraits, landscapes, and product images to life.
Start/End Transitions — Morph smoothly from one image to another.
Marketing & Ads — Turn product photos into dynamic promotional videos.
Storytelling — Animate illustrations and artwork for narratives, with matching sound.

Pro Tips

Be specific about movement direction, speed, and camera angles.
Describe the scene's audio (traffic, music, crowd) to shape the generated soundtrack.
When using a last frame, keep the two images' aspect ratios close for a clean transition.
Use high-quality source images for better video results.

Notes

The first-frame image is required; the prompt is optional but strongly recommended.
The last-frame image is optional; when provided, the clip ends on it.
ESR tiers add an enhancement stage after native generation and may take longer than native resolutions.
Ensure image URLs are publicly accessible.
Generation is asynchronous — submit, then poll for the finished video.

MiniMax H3-Sol Text-to-Video — Generate video directly from a text prompt.
MiniMax H3-Sol Reference-to-Video — Keep a subject consistent from reference materials.