ToAPIs
    InicioToAPIs
    Generación de imágenesGPT Image 2.6, Gemini, FLUX…Generación de videoSeedance, Veo, Kling, Sora…Chat y redacciónGPT-5.6, Claude, DeepSeek…Voz y músicaLocuciones, TTS, audio
    NovedadSeedance 2.5
    PreciosDocumentación de APIMCP
    BlogAlternativas
    Iniciar sesiónEmpieza gratis
    Todos los modelosPreciosDocumentación de APIMCPBlogAlternativas
    Iniciar sesiónEmpieza gratis

    Idioma

    Esc
    • Seedance 2.5Generación de video
    • GPT Image 2Generación de imágenes
    • GPT Image 2.6Generación de imágenes
    • GPT Image 2.5Generación de imágenes
    • Veo 3.1 FastGeneración de video
    • Kling 3.0 TurboGeneración de video
    • Kling V4 FlashGeneración de video
    • Grok Video 1.5Generación de video
    • Nano Banana 2Generación de imágenes
    • Seedream 5.5Generación de imágenes
    • FLUXGeneración de imágenes
    • Sora 2Generación de video
    • Todos los modelos de imagenCategoría
    • Todos los modelos de videoCategoría
    • GPT-5.6 SolChat y código
    • Claude Opus 4.8Chat y código
    • Claude Opus 4.7Chat y código
    • DeepSeek V4 ProDeepSeek · Texto
    • Gemini Omni 1.1 FlashGoogle · Multimodal
    1. Inicio
    2. Blog
    3. Tutorial
    4. Guía de la API de MiniMax H3: texto a vídeo y entradas de referencia
    Volver a todos los artículos
    tutorial2026-10-2212 min de lectura

    Guía de la API de MiniMax H3: texto a vídeo y entradas de referencia

    Guía práctica para llamar a los modelos de vídeo MiniMax H3 a través de ToAPIs: ejemplos de solicitud, modos de entrada admitidos, límites por modelo e indicaciones para consultar el estado de la tarea.

    ToAPIs Engineering Team
    MiniMax H3API de vídeoR2VPythonTutorial
    TL;DR - Puntos clave
    • El ID de modelo de la API determina qué variante de H3 tienes disponible; usa el ID exacto habilitado para tu cuenta.
    • El contrato actual del frontend de ToAPIs admite clips de 4 a 15 segundos en la familia H3 base, con límites de resolución distintos según la variante.
    • Usa entradas de primer y último fotograma, o material de referencia, dentro de una misma solicitud; no mezcles los dos modos.
    • Esta guía documenta la construcción de solicitudes, no una comparativa de latencia, calidad, disponibilidad o precio.

    Guía de la API de MiniMax H3: texto a vídeo y entradas de referencia

    Las solicitudes a MiniMax H3 son fáciles de configurar mal cuando un cliente trata todas las variantes del modelo como si fueran intercambiables. El ID de modelo que elijas afecta la validación de la duración y de la resolución, mientras que el modo de medios decide qué campos de imagen, vídeo y audio puedes enviar juntos.

    Esta guía describe el contrato de solicitud tal como está implementado en el frontend de ToAPIs a 22 de octubre de 2026. Es una guía de integración, no un informe sobre el rendimiento del proveedor upstream ni sobre el precio actual de tu cuenta. Confirma que tu cuenta tiene acceso al modelo que vas a usar antes de enviar trabajos de producción.

    Inicio rápido

    El endpoint de generación que usan los ejemplos de la API de ToAPIs es POST /v1/videos/generations. Autentícate con una clave de API de ToAPIs y envía un prompt, un ID de modelo habilitado, la duración y la relación de aspecto. Por ejemplo:

    bash
    curl -X POST "https://api.toapis.com/v1/videos/generations" \
      -H "Authorization: Bearer $TOAPIS_API_KEY" \
      -H "Content-Type: application/json" \
      -d '{
        "model": "minimax-h3",
        "prompt": "A slow cinematic pan across a quiet coastal town at sunrise",
        "duration": 5,
        "ratio": "16:9"
      }'
    

    Trata la respuesta como el envío de una tarea asíncrona. Lee el identificador de tarea que devuelve la respuesta de la API de tu cuenta y consulta su estado con el endpoint de estado documentado. No des por hecho un formato de respuesta fijo salvo que la referencia de la API de tu cuenta lo especifique.

    python
    import os
    import time
    import requests
    
    BASE_URL = "https://api.toapis.com/v1"
    API_KEY = os.environ["TOAPIS_API_KEY"]
    headers = {"Authorization": f"Bearer {API_KEY}"}
    
    response = requests.post(
        f"{BASE_URL}/videos/generations",
        headers=headers,
        json={
            "model": "minimax-h3",
            "prompt": "A slow cinematic pan across a quiet coastal town at sunrise",
            "duration": 5,
            "ratio": "16:9",
        },
        timeout=30,
    )
    response.raise_for_status()
    submission = response.json()
    print("Submission response:", submission)
    

    El ejemplo imprime la respuesta a propósito, en lugar de suponer dónde aparecen el ID de la tarea o la URL del vídeo. Ajusta el código de lectura y de consulta al esquema de respuesta documentado para tu cuenta. Así evitas tratar en silencio un formato modificado como si fuera una tarea correcta.

    Elige el ID de modelo exacto

    El frontend reconoce minimax-h3 y minimax-h3-global como ID de la familia base, además de los ID que contienen minimax-h3-max. Por ejemplo, el ID del modelo Turbo que se usa en el producto es minimax-h3-max-turbo. Usa el identificador canónico que aparece en el catálogo de modelos disponibles y evita inventar alias o acortar el ID.

    En este momento el frontend aplica estos límites de capacidad:

    Familia / ID de modeloDuración aceptada por el frontendOpciones de resolución representadas en el frontend
    minimax-h3 y minimax-h3-globalDe 4 a 15 segundos, entero2K, 768p
    minimax-h3-max-turbo y otras variantes MaxDe 5 a 15 segundos, entero480P, 768P
    minimax-h3-max canónicoDe 5 a 15 segundos, enteroOpciones Max más 1080P

    Son restricciones de validación del frontend, no una garantía de que todas las cuentas o rutas upstream tengan la misma disponibilidad. En particular, la opción extra de 1080P solo está asociada al ID canónico exacto minimax-h3-max en el cliente actual. No supongas que Turbo, un alias -global o cualquier modelo H3 admite 1080P.

    Elige un solo modo de medios

    El formulario de H3 admite dos flujos de trabajo mutuamente excluyentes:

    1. Modo de fotogramas: envía como máximo un first_frame_image y como máximo un last_frame_image. El cliente selecciona una relación de aspecto adaptativa cuando hay entradas de fotograma.
    2. Modo de referencia: envía imágenes, vídeos y/o audios de referencia sin entradas de primer ni último fotograma. El cliente usa la relación de aspecto seleccionada para esas referencias.

    Ejemplo de solicitud con primer fotograma:

    json
    {
      "model": "minimax-h3",
      "prompt": "The subject turns toward the camera as the camera gently moves forward",
      "duration": 5,
      "ratio": "16:9",
      "first_frame_image": ["https://example.com/starting-frame.jpg"]
    }
    

    Ejemplo de solicitud con material de referencia:

    json
    {
      "model": "minimax-h3",
      "prompt": "Use the supplied references to guide the scene and motion",
      "duration": 5,
      "ratio": "16:9",
      "media_mode": "reference",
      "reference_images": ["https://example.com/character-reference.jpg"],
      "reference_videos": ["https://example.com/motion-reference.mp4"]
    }
    

    El formato exacto de los valores para el material que subes depende del flujo de carga de medios de la pasarela. Estos ejemplos muestran los campos de la solicitud, no afirman que cualquier URL pública sea aceptada por todas las rutas. Usa las URL o los identificadores de recursos que devuelve el flujo de carga documentado.

    El frontend aplica estos límites de referencia:

    • Hasta 9 imágenes de referencia.
    • Hasta 3 vídeos de referencia.
    • Hasta 3 audios de referencia.
    • Como máximo 12 recursos de referencia en total.
    • Cada vídeo de referencia debe durar entre 2 y 15 segundos, y la duración total de las referencias enviadas no puede superar los 15 segundos.
    • Las referencias de audio requieren al menos una referencia visual.
    • Las solicitudes Turbo no pueden incluir material de referencia.

    Respeta estas restricciones antes de enviar. Una solicitud que mezcla modos de entrada, supera un recuento u omite el contexto visual necesario se rechaza localmente en el frontend, en lugar de enviarse como una solicitud válida de generación H3.

    Opciones de prompt y de generación

    El prompt es obligatorio y el frontend actual lo limita a 7.000 caracteres Unicode. Describe la escena, el sujeto, el movimiento y la intención visual en lenguaje natural. Trata las etiquetas de cámara entre corchetes y cualquier otra sintaxis especial como texto normal del prompt, salvo que la documentación del modelo upstream las defina de forma explícita. La evidencia disponible en el contrato del frontend no confirma que cadenas como [Pan Left] sean comandos nativos de H3.

    El generador de solicitudes pasa controles opcionales admitidos, como prompt_optimizer, watermark y seed, según la ruta del modelo elegido. No des por hecho que todas las rutas upstream aceptan esos campos opcionales de la misma manera. Si los expones en tu propia interfaz, valídalos contra el catálogo específico del modelo y elimina los campos obsoletos cuando el usuario cambie de variante.

    Para la relación de aspecto, el frontend acepta adaptive, 21:9, 16:9, 4:3, 1:1, 3:4 y 9:16. Las entradas de fotograma fuerzan adaptive. En texto a vídeo, una selección adaptativa se normaliza a 16:9; el modo de referencia mantiene la relación admitida que se haya solicitado.

    Crea prompts que se puedan probar

    Escribir prompts no es un parámetro de la API, pero influye en cuán útil resulta una integración técnica para la persona que la usa. Pide a los usuarios que describan una escena y una acción principal antes de añadir dirección de cámara, ilusión o estilo. Un prompt compacto puede especificar el sujeto, la acción, el entorno y el comportamiento de la cámara en ese orden. Mantén esas piezas estables durante una comparación de modelos; de lo contrario, un cambio de redacción puede explicar un resultado distinto.

    No prometas que una frase concreta garantiza un movimiento de cámara, la coincidencia de identidad, una tasa de fotogramas o un estilo visual. El contrato del frontend valida el prompt como texto y aplica un límite de caracteres. No define una gramática de comandos estándar para las etiquetas de cámara. Si tu aplicación ofrece controles de prompt predefinidos, etiquétalos como ayudas de prompt y no como controles garantizados del modelo, salvo que la documentación upstream confirme ese comportamiento.

    Para flujos de generación repetidos, guarda la versión de la plantilla de prompt junto al registro de la tarea. Así puedes distinguir un cambio de modelo de un cambio de prompt cuando los usuarios informan resultados distintos. Evita incluir claves de API, identificadores privados o datos personales en los prompts. Revisa el contenido del prompt contra las políticas de contenido y privacidad de tu producto antes de permitir envíos por lotes sin supervisión.

    Normaliza la relación de aspecto y la resolución con criterio

    La relación de aspecto y la resolución responden a preguntas diferentes: la relación describe la forma de la salida, mientras que la resolución elige un tamaño de salida admitido por la ruta del modelo. Que una relación se acepte no implica que cualquier resolución pueda combinarse con ella. Mantén ambos campos en la interfaz y valídalos contra el modelo seleccionado en ese momento.

    Si el usuario elige el modo de primer fotograma o de primer y último fotograma, el frontend fuerza una relación adaptativa para que los fotogramas de entrada guíen la forma del lienzo. No muestres una relación personalizada contradictoria como si fuera a respetarse. En el modo de texto a vídeo, la opción adaptativa se resuelve al comportamiento predeterminado de 16:9 en el generador actual. Si haces visible esa normalización, muestra el valor realmente enviado en un paso de revisión para que los usuarios entiendan qué recibe la pasarela.

    Las etiquetas de resolución también difieren en mayúsculas entre variantes (768p frente a 768P). Normalízalas solo si el contrato de la API del modelo seleccionado lo permite de forma explícita. Evita convertir los valores del modelo de forma global, porque un valor aceptado por una ruta puede ser rechazado por otra.

    Consulta de estado y errores

    La generación de vídeo es asíncrona. Después de enviar la solicitud, guarda el identificador de la tarea y consulta el endpoint de estado documentado para tu cuenta de API. Usa retroceso exponencial acotado con fluctuación aleatoria en lugar de un bucle ajustado, fija una fecha límite global y trata el fallo definitivo por separado del tiempo de espera agotado. Un tiempo de espera agotado no demuestra que la tarea upstream haya fallado; comprueba el estado de la tarea antes de reintentar una generación facturable.

    Como mínimo, tu cliente debería:

    • Llamar a raise_for_status() o su equivalente en las respuestas HTTP.
    • Leer la respuesta de acuerdo con el esquema de API publicado.
    • Dejar de consultar cuando llegue a un estado final de éxito o de fallo documentado.
    • Limitar el número de reintentos y el tiempo total transcurrido.
    • Evitar enviar una generación duplicada solo porque una solicitud del lado del cliente agotó el tiempo de espera.
    • Registrar un identificador de solicitud o de tarea, pero nunca la clave de API ni las URL de medios privados.

    Las categorías genéricas de error que aparecen abajo son puntos de partida para el diagnóstico, no una garantía de los códigos de error exactos de ToAPIs:

    Estado HTTPCategoría habitualAcción recomendada
    400Campo inválido, valor no admitido o conflicto de modo de mediosRevisa el ID de modelo, la duración, la resolución, la relación y los recuentos de entrada.
    401Clave de API ausente o inválidaRevisa la clave en tu gestor de secretos y las cabeceras de la solicitud.
    429Límite de frecuencia o de concurrenciaRetrocede con fluctuación aleatoria y reintenta solo cuando sea seguro.
    5xx o tiempo de espera agotado en la redProblema temporal de la pasarela o del upstreamComprueba el estado de la tarea antes de reenviar; usa una política de reintentos acotada.

    Precios y garantías de servicio

    Los precios, el tiempo de actividad, el comportamiento de los reembolsos y los acuerdos de nivel de servicio pueden variar según el modelo, la ruta y la cuenta. Esta guía no cita a propósito un precio por segundo ni promete un SLA de disponibilidad. Consulta el catálogo actual de modelos de ToAPIs y el precio de tu cuenta antes de estimar los costes de un proyecto. No uses un precio de borrador de planificación como cotización de producción.

    Un flujo de trabajo más seguro para construir solicitudes

    Mantén la selección y la validación del modelo en un solo lugar de tu aplicación. Cuando el usuario cambie de modelo, vuelve a construir las opciones permitidas en lugar de arrastrar todos los campos de la selección anterior a la siguiente solicitud. Esto importa al pasar de H3 base a Max o Turbo: una resolución, una lista de medios de referencia o un valor de duración pueden ser válidos para un modelo e inválidos para otro.

    Una secuencia fiable del lado del cliente es esta:

    1. Lee el ID del modelo seleccionado en ese momento desde el catálogo de modelos.
    2. Carga las opciones de duración y de resolución de ese modelo.
    3. Pide al usuario que elija el modo de fotogramas o el modo de referencia.
    4. Valida los recuentos de campos y la compatibilidad antes de subir medios.
    5. Sube los medios elegidos mediante el endpoint de recursos documentado.
    6. Construye un objeto de solicitud nuevo a partir de los valores validados.
    7. Envía una sola vez, guarda el identificador de tarea devuelto y muestra el estado de la tarea al usuario.

    Evita modificar in situ un objeto de solicitud antiguo. Un objeto nuevo reduce la probabilidad de que un campo como reference_videos se filtre a una solicitud Turbo después de cambiar de modelo. El contrato del frontend de ToAPIs también hace explícito el modo: media_mode puede ser frame o reference, y las entradas mezcladas se rechazan.

    Para una integración propia, replica estas comprobaciones antes de la llamada de red:

    python
    def validate_h3_request(model, duration, resolution, frame_images, refs):
        is_max_family = "minimax-h3-max" in model
        is_turbo = "turbo" in model
        min_duration = 5 if is_max_family else 4
    
        if not isinstance(duration, int) or not min_duration <= duration <= 15:
            raise ValueError("Duration is outside this model's supported range")
        if len(frame_images) > 2:
            raise ValueError("Use at most one first frame and one last frame")
        if frame_images and refs:
            raise ValueError("Frame inputs and reference media are separate modes")
        if is_turbo and refs:
            raise ValueError("This Turbo route does not accept reference media")
        if len(refs.get("images", [])) > 9:
            raise ValueError("Too many reference images")
        if len(refs.get("videos", [])) > 3:
            raise ValueError("Too many reference videos")
    

    Esta es una protección ilustrativa del lado del cliente, no un sustituto de la validación en el servidor. El código de producción debería además validar cada tipo de medio, calcular el recuento total de referencias y la duración de los vídeos, aplicar la lista de resoluciones específica del modelo y usar los identificadores reales que devuelve el flujo de carga.

    Consideraciones sobre carga y privacidad

    Trata el material de referencia como datos del usuario. Sube solo archivos que el usuario esté autorizado a usar y asegúrate de que tus reglas de retención y de acceso cubren las imágenes, los audios y los vídeos de origen. No publiques medios de origen privados en URL públicas solo para simplificar una demostración. Si la API devuelve una URL temporal de recurso, evita escribirla en herramientas de analítica o en registros de larga duración.

    Valida los archivos antes de subirlos: rechaza extensiones y tipos MIME no admitidos, aplica los límites documentados de tamaño y de cantidad, y muestra un error claro antes de dedicar tiempo a una solicitud de generación. Mantén el identificador de carga asociado al registro de la tarea, pero no expongas rutas de almacenamiento internas en una página pública. Si una carga falla, detente antes de crear una tarea de generación en lugar de enviar una solicitud incompleta.

    Para los reintentos, distingue las lecturas idempotentes de los envíos de generación facturables. Reintentar una comprobación de estado con GET suele ser distinto de repetir un POST que ya puede haber creado una tarea. Si el cliente pierde la respuesta del envío, usa primero cualquier identificador de solicitud o mecanismo de recuperación documentado para la cuenta. Si no existe ninguno, muestra un estado incierto al operador en lugar de crear en silencio un duplicado.

    Lista de verificación para el despliegue

    Antes de publicar una integración de H3, prueba al menos una solicitud válida por cada ID de modelo habilitado para tu cuenta. Añade pruebas negativas con una duración fraccionaria, una resolución no admitida, demasiadas referencias, entradas de fotograma y referencia combinadas, y referencias en Turbo. Verifica que la interfaz borra los valores incompatibles después de un cambio de modelo.

    En el entorno de pruebas, registra los campos de la solicitud después de la validación y compáralos con el esquema documentado de la pasarela. No captures claves de API ni datos de medios privados en los registros. Confirma la URL de consulta de estado, los estados de la tarea y el campo de resultado con un fixture que no sea de producción o con una cuenta de prueba aprobada. Este artículo no llama a un endpoint en vivo ni valida el comportamiento del servicio remoto.

    Por último, comprueba el precio de la cuenta del usuario y el catálogo de modelos justo antes del lanzamiento. La disponibilidad y el precio de los modelos son información propia de cada cuenta; los valores copiados en un artículo antiguo pueden quedar obsoletos aunque los campos de la solicitud no cambien.

    Modelos relacionados y siguientes pasos

    • Explora los modelos de vídeo
    • Abre el Playground con MiniMax H3
    • Abre el Playground con MiniMax H3 Max Turbo

    Antes de desplegar, verifica el ID de modelo exacto, la disponibilidad actual de la ruta, el formato de carga, el esquema de respuesta y el precio de la cuenta en la documentación de la API que tengas disponible.

    Explora los modelos mencionados en este artículo

    MiniMaxVIDEO

    minimax-h3

    Tarifa actual: 20.8 credits /second
    Guía del modeloProbar en la consolaObtener clave de API
    MiniMaxVIDEO

    minimax-h3-max

    Tarifa actual: 8 credits /second
    Guía del modeloProbar en la consolaObtener clave de API
    ToAPIsAI Model

    minimax-h3-max-turbo

    Tarifa actual: Ver precios en vivo
    Guía del modeloProbar en la consolaObtener clave de API

    Artículos relacionados

    tutorial2026-11-10T14:00:00+08:006 min de lectura

    Cómo crear un pipeline automatizado de imagen a vídeo (R2V) con la API de MiniMax H3

    Tutorial de ingeniería para un pipeline automatizado de Reference-to-Video con MiniMax H3: entradas de primer fotograma, preparación de recursos, sondeo acotado de tareas y el contrato de solicitud del frontend de ToAPIs.

    TO
    ToAPIs Engineering & Evaluation Team
    #MiniMax H3
    tutorial2026-11-10T10:00:00+08:006 min de lectura

    Guía de prompts de MiniMax H3: cómo crear movimientos de cámara cinematográficos vía API

    Guía para desarrolladores sobre cómo escribir prompts de movimientos de cámara cinematográficos para la API de vídeo MiniMax H3 en ToAPIs: plantillas reutilizables, ejemplos en cURL y Python, y el contrato de solicitud actual del frontend.

    TO
    ToAPIs Engineering & Evaluation Team
    #MiniMax H3
    tutorial2026-11-11T10:00:00+08:007 min de lectura

    Integración de la API de MiniMax Hailuo 2.3: generar movimiento humano complejo en vídeo con IA

    Guía para desarrolladores sobre la API de vídeo MiniMax Hailuo 2.3 en ToAPIs: patrones de prompt para movimiento humano, el contrato actual de solicitud para trabajos de 6 y 10 segundos en 768P y 1080P, y ejemplos en cURL y Python.

    TO
    ToAPIs Engineering & Evaluation Team
    #MiniMax Hailuo
    ToAPIs
    InicioToAPIs
    Pasarela empresarial de API de IA. Accede a GPT-5, Claude, Gemini y más de 200 modelos mediante una única API unificada.

    Modelos populares

    • Seedance 2.5 API
    • Seedance 2.0 API
    • Veo 3.1 Fast API
    • Kling 3.0 Turbo API
    Mostrar másMostrar menos
    • GPT Image 2 API
    • Claude Opus 4.8 API
    • Nano Banana 2 API
    • Seedance 2 Mini API
    • Todos los modelos

    Categorías de API

    • API de imagen con IA
    • API de vídeo con IA
    • API texto a vídeo
    • API imagen a vídeo
    Mostrar másMostrar menos
    • API de edición de imágenes con IA
    • API de LLM y razonamiento
    • Todas las herramientas API →

    Alternativas

    Alternativas
    • Alternativa a Kie.ai
    • Alternativa a Fal.ai
    • Alternativa a OpenRouter
    • Alternativa a Replicate
    • Alternativa a Wavespeed AI
    • Todas las comparativas →

    Guías destacadas

    Guías destacadas
    • Precios de Seedance 2.0 y 2.5
    • Guía de la API Seedance más económica
    • Guía de integración de MiniMax H3
    • Clave de API gratuita de Seedance 2
    • Inicio rápido de la API Seedance 2
    • Todos los artículos técnicos →

    Desarrolladores y plataforma

    Desarrolladores y plataforma
    • Documentación de API
    • MCP
    • Precios
    • Área de pruebas de modelos
    • LLMs.txt
    • Contactar con soporte
    • Directorio de guías de modelos
    Entidad operadora:
    鯨樞智能科技有限公司
    JINGSHU INTELLIGENT LIMITED
    Domicilio social:
    ROOM 5042, 5/F, YAU LEE CENTRE, NO.45, HOI YUEN ROAD, KWUN TONG, KOWLOON, HONG KONG
    PrivacidadTérminosUso aceptableEliminación de datosConservación de datosSubencargados y regionesFacturación y reembolsosPolítica de cookiesMapa del sitioAcerca de

    © 2026 ToAPIs. Todos los derechos reservados.