MiniMax H3 API
MiniMax H3 es la ruta de vídeo de MiniMax en OmniaKey: un solo identificador cubre texto a vídeo, un primer fotograma con un último opcional y planos guiados por referencias, en 768P o 2K.
- ID del modelo
- minimax-h3
- Proveedor
- MiniMax
- Modalidad
- AI Vídeo
- Por segundo de salida
- $0,15–$0,30
- Última verificación
- 2026-09-16
01
Para qué sirve
Elige MiniMax H3 cuando el plano necesite un fotograma inicial y final fijos o movimiento guiado por imágenes y vídeos de referencia, a $0.15 por segundo en 768P y $0.30 en 2K. Una referencia de audio sola se rechaza: acompáñala de una referencia de imagen o vídeo.
02
Qué hace
Texto a vídeo
minimax-h3
Genera un vídeo corto a partir de un texto.
Imagen a vídeo
minimax-h3
Anima una imagen fija en un vídeo corto.
Vídeo de referencia
minimax-h3
Usa metraje de referencia para guiar el vídeo generado.
03
Cómo llamarlo
Los modelos de medios funcionan de forma asíncrona: crea una tarea, consúltala hasta que termine y descarga la URL firmada del recurso.
# 1. Create the job. 202 Accepted; the body carries the task id,
# the pre-charged price, and a poll_url. Reuse one Idempotency-Key
# across retries so a timeout never starts a second paid job.
curl --fail-with-body https://api.omniakey.com/v1/media/tasks \
-H "Authorization: Bearer $OMNIAKEY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: minimax-h3-001" \
-d '{
"model": "minimax-h3",
"type": "video",
"operation": "text_to_video",
"input": {"prompt": "a paper boat on a quiet lake at sunset"},
"parameters": {"duration": 6, "resolution": "720p"}
}'
# 2. The same model id and the same poll loop serve the other operations:
# image_to_video media[] type "first_frame"
# reference_to_video media[] type "reference_image"
# Reference media travel alongside the prompt:
# {"prompt": "...", "media": [{"type": "first_frame", "url": "https://example.com/first-frame.png"}]}
# A public HTTPS URL or a base64 data URI both work.
# 3. Poll GET /v1/media/tasks/{id} until status is
# succeeded | failed | canceled. Progress carries percent and stage.
curl --fail-with-body https://api.omniakey.com/v1/media/tasks/TASK_ID \
-H "Authorization: Bearer $OMNIAKEY_API_KEY"
# 4. Download assets[0].url before expires_at, or poll again for a
# fresh signed URL. Failed and canceled jobs are refunded.
curl -sS -o out.mp4 "$(jq -r '.assets[0].url' result.json)"04
Precio
Los trabajos de vídeo se cobran por segundo de salida generado, no por token. Los trabajos fallidos o cancelados se reembolsan automáticamente.
$0,15–$0,30por segundo
- 768P
- $0,15por segundo
- 2K
- $0,30por segundo
Preguntas frecuentes
¿Cómo llamo a MiniMax H3 en OmniaKey?
Envía un POST a /v1/media/tasks con el id del modelo, type "video" y operation "text_to_video"; o "image_to_video" con un primer fotograma en input.media[] (type "first_frame"). Reutiliza la misma Idempotency-Key en los reintentos para que un timeout nunca inicie un segundo trabajo de pago.
¿Cuánto cuesta MiniMax H3?
MiniMax H3 se cobra a $0,15–$0,30 por segundo de vídeo generado. La creación pre-cobra la duración solicitada de tu saldo prepago y los trabajos fallidos o cancelados se reembolsan automáticamente.
¿Por qué la API devuelve un id de tarea en lugar del vídeo?
El renderizado de vídeo tarda entre un minuto y varios minutos, así que OmniaKey ejecuta todas las rutas de vídeo con el mismo ciclo asíncrono. Consulta GET /v1/media/tasks/{id} hasta que el estado sea succeeded y luego lee la URL firmada del recurso.
