MercadoSoporte← Volver a la app

MiniMax H3

Los modelos de MiniMax H3 se llaman a través de una API de trabajos asíncrona y unificada. Inicia una tarea con POST /api/generate y luego sondea GET /api/generate/{taskId} hasta que termine. Esta familia expone 3 endpoints.

Resumen

Todos los endpoints comparten la misma envoltura — solo cambian model y los campos input. Ejecuta cualquiera desde el playground del Mercado de modelos.

Autenticación

Crea una API key en /api-keys y luego envíala como token Bearer. Las solicitudes desde el navegador con sesión iniciada también funcionan mediante la cookie de sesión.

Authorization: Bearer <YOUR_API_KEY>

Crear tarea

POST
POST https://api.lithovas.com/api/generate

Cuerpo: { "model": "<slug>", "input": { … } }

Respuesta: { "taskId": "<id>", "state": "waiting" }

Consultar resultado

GET
GET https://api.lithovas.com/api/generate/<taskId>

Respuesta: { "taskId", "state": "waiting" | "success" | "fail", "resultUrls": [ … ], "creditsConsumed", "failMsg", "balance" }

Asíncrono
Un 200 de Crear tarea solo significa que la tarea fue aceptada — no que haya terminado. Sondea este endpoint hasta que state sea success o fail. Las tareas fallidas no se facturan.

Endpoints

ModeloTareamodel slug
MiniMax H3Text to Videominimax-h3/text-to-video
MiniMax H3Image to Videominimax-h3/image-to-video
MiniMax H3Video to Videominimax-h3/reference-to-video

MiniMax H3 · Text to Video

POSTText to Videominimax-h3/text-to-video
campos input
promptstringobligatorio

Text prompt describing the desired video.

durationintegeropcional

Output video duration in seconds.

aspect_ratioenum<string>opcional

Output video aspect ratio.

resolutionenum<string>opcional

Output video resolution tier currently exposed on the relay.

seedintegeropcional

Random seed for reproducible generation.

Ejemplo
cURL
curl -X POST https://api.lithovas.com/api/generate \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "minimax-h3/text-to-video",
  "input": {
    "prompt": "A cinematic red panda surfing through neon rain at dusk.",
    "duration": 5,
    "aspect_ratio": "16:9",
    "resolution": "768p",
    "seed": 42
  }
}'

MiniMax H3 · Image to Video

POSTImage to Videominimax-h3/image-to-video
campos input
promptstringobligatorio

Text prompt describing the desired motion and style.

image_urlsarray<string>obligatorio

One or more input image URLs used to drive the video.

durationintegeropcional

Output video duration in seconds.

aspect_ratioenum<string>opcional

Output video aspect ratio.

resolutionenum<string>opcional

Output video resolution tier currently exposed on the relay.

seedintegeropcional

Random seed for reproducible generation.

Ejemplo
cURL
curl -X POST https://api.lithovas.com/api/generate \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "minimax-h3/image-to-video",
  "input": {
    "prompt": "Animate the image with natural motion, subtle camera movement, and cinematic lighting.",
    "image_urls": [
      "https://example.com/input.jpg"
    ],
    "duration": 5,
    "aspect_ratio": "16:9",
    "resolution": "768p",
    "seed": 42
  }
}'

MiniMax H3 · Video to Video

POSTVideo to Videominimax-h3/reference-to-video
campos input
promptstringobligatorio

Prompt describing the target video, style, motion, and atmosphere.

reference_imagearray<string>obligatorio

Reference image URLs for subject and style consistency.

videos_listarray<string>opcional

Optional reference video URLs for motion and camera guidance.

audios_listarray<string>opcional

Optional reference audio URLs for voice, music, or ambience guidance.

durationintegeropcional

Output video duration in seconds.

aspect_ratioenum<string>opcional

Output video aspect ratio.

resolutionenum<string>opcional

Output video resolution tier currently exposed on the relay.

seedintegeropcional

Random seed for reproducible generation.

Ejemplo
cURL
curl -X POST https://api.lithovas.com/api/generate \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "minimax-h3/reference-to-video",
  "input": {
    "prompt": "Restyle the source footage with richer lighting, cleaner motion, and a cinematic grade.",
    "reference_image": [
      "https://example.com/input.jpg"
    ],
    "videos_list": [
      "https://example.com/reference.mp4"
    ],
    "audios_list": [
      "https://example.com/reference.mp3"
    ],
    "duration": 5,
    "aspect_ratio": "16:9",
    "resolution": "768p",
    "seed": 42
  }
}'