Por ahora esta guía solo está en inglés. →
Parámetros de la petición
| Parámetro | Obligatorio | Descripción |
|---|---|---|
aspect_ratio | No | La forma del encuadre: horizontal, cuadrado o vertical. 16:9 · 9:16 · 1:1 · 4:3 · 3:4 · 21:9 · Por defecto: 16:9 |
duration_seconds | No | Cuánto dura el clip. Se cobra por segundo. ≥ 4 · ≤ 15 · Por defecto: 5 |
enable_prompt_expansion | No | Deja que el modelo añada detalles a un prompt corto. false · Por defecto: false |
prompt | Sí | Refer to the references by number and describe the shot they should produce. |
reference_audio_urls | No | Audio que imitar: una voz, una música o un ritmo. |
reference_image_urls | Sí | Imágenes de las personas, prendas o lugares que el resultado debe mantener. |
reference_video_urls | No | Clips cuyo movimiento, cámara o estilo debe seguir el resultado. |
resolution | No | Tamaño de salida. Más grande es más nítido y cuesta más. 768p · 2k · Por defecto: 768p |
Precios
Los precios están en créditos, los mismos que usas en la web (1 crédito = 0,01 $). El importe se retiene cuando se acepta la tarea y se liquida al coste real cuando termina; las tareas fallidas se reembolsan.
| Opción | Créditos por segundo | ≈ USD |
|---|---|---|
| resolution 768p | 5,55 | 0,056 US$ |
| resolution 2K | 8,7 | 0,087 US$ |
Cada tarea se redondea al alza a créditos enteros, así que una ejecución en el nivel más bajo cuesta 28 créditos por un clip de 5 segundos (0,28 US$).
Para saber la cifra exacta antes de ejecutar, envía el mismo cuerpo a POST /jobs/quote.
Inicio rápido de la API
Llama a la API de MiniMax H3 en tres pasos
- Crea una clave de API. Inicia sesión en PopNow y crea una clave en la consola de la API. Las claves empiezan por sk-popnow- y usan los mismos créditos que el sitio web.
- Envía la solicitud. Haz POST /jobs/createTask con model minimax/h3/reference-to-video y un objeto input según la tabla de parámetros. La respuesta devuelve un ID de tarea al instante.
- Obtén el resultado. Consulta GET /jobs/recordInfo con el ID de tarea, o pasa una callBackUrl y te enviamos el resultado ahí. Descarga los enlaces de salida cuando la tarea termine bien.
# 1. Create the task. Keep the Idempotency-Key if you retry after a network error.
export IDEMPOTENCY_KEY="$(uuidgen)"
curl -X POST https://api.popnow.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $POPNOW_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $IDEMPOTENCY_KEY" \
-d '{
"model": "minimax/h3/reference-to-video",
"input": {
"prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
"reference_image_urls": [
"https://media.popnow.ai/influencer/examples/ava.webp"
],
"aspect_ratio": "16:9",
"resolution": "768p",
"duration_seconds": 5
}
}'
# 2. Copy data.taskId from the response, then poll until state is succeeded, failed, canceled or expired.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $POPNOW_API_KEY"Sustituye el prompt y los enlaces por los tuyos. La pestaña API tiene la referencia de la respuesta, el sondeo y el callback.
Preguntas sobre la API de MiniMax H3
¿Cuánto cuesta la API de MiniMax H3?
MiniMax H3 cuesta desde 28 créditos (0,28 US$) por un clip de 5 segundos con Referencias a video, su tarea más barata. Precios por opción: 768p 5,55 créditos por segundo, 2K 8,7 créditos por segundo. Los créditos son los mismos que en la web (1 crédito = 0,01 $), las cuentas nuevas reciben 30 créditos gratis y las tareas fallidas se reembolsan.
¿Cuál es el nombre de modelo de MiniMax H3 en la API?
Pon minimax/h3/text-to-video para Crear video; minimax/h3/image-to-video para Imagen a video; minimax/h3/reference-to-video para Referencias a video; minimax/h3/video-extend para Extender video en el campo model de POST /jobs/createTask.
¿Cuánto puede durar un video de MiniMax H3?
Hasta 15 segundos por clip. Para una escena más larga, guarda el último cuadro de un clip que te guste y úsalo como cuadro inicial del siguiente: el vestuario, el set y la luz se conservan.
¿MiniMax H3 genera sonido?
Sí. Ambiente, pasos, música y diálogos salen en el mismo archivo que la imagen. Describe el sonido que quieres en el prompt, igual que describes la toma.
¿Cómo mantengo el mismo personaje en cada clip?
Usa referencia a video. Dale hasta nueve fotos, cada una con una función (cara, vestuario, cuarto), y nómbralas Picture 1, Picture 2 en el prompt. Tres o cuatro fotos claras sostienen una cara mejor que nueve que se repiten.
¿Me cobran si una generación falla?
No. Si una generación falla, el monto reservado para ella vuelve de inmediato a tu saldo.
¿Qué límites tiene la API de MiniMax H3?
Duración del clip: 4–15 s; Resoluciones: 768p · 2K; Relaciones de aspecto: 16:9 · 9:16 · 1:1 · 4:3 · 3:4 · 21:9; Audio de referencia: 3; Imágenes de referencia: 9. Las peticiones fuera de estos límites se rechazan antes de cobrar nada.
¿Puedo probar MiniMax H3 sin escribir código?
Sí. El Playground ejecuta MiniMax H3 con tus créditos de PopNow, no necesita clave API y te muestra el código de cada generación.
Todos los modelos de MiniMax
MiniMax H3 Max es la variante de generación rápida, con un último fotograma opcional pero sin modo de referencia ni 2K. H3 es el todoterreno.
- API de MiniMax H3Clips expresivos con audio, hasta 2KDesde 28 créditos por un clip de 5 segundos
- API de MiniMax Speech 2.8 HDVoz de alta fidelidad con más de 400 voces y control emocionalDesde 18 créditos por 1.000 caracteres
- API de MiniMax Music 3.0Canciones estéreo terminadas, con voz o instrumentalesDesde 27 créditos por generación
- API de MiniMax H3 Singularity LoRAVideo H3 ajustado por la comunidad que carga tus LoRADesde 45 créditos por un clip de 5 segundos
- API de MiniMax H3 MaxClips rápidos con ambiente, efectos y músicaDesde 38 créditos por un clip de 5 segundos
- API de MiniMax H3 LoRAVideo MiniMax H3 con sonido y hasta tres de tus LoRADesde 38 créditos por un clip de 5 segundos
- API de MiniMax H3 Image LoRAImágenes y ediciones con H3 y hasta tres de tus LoRADesde 7 créditos por imagen
- API de MiniMax Speech 2.8 TurboVoz rápida con más de 400 voces y control emocionalDesde 11 créditos por 1.000 caracteres
Más sobre MiniMax H3
- Comparar
- Kling 3.0 vs MiniMax H3

