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. Integración de la API de MiniMax Hailuo 2.3: generar movimiento humano complejo en vídeo con IA
    Volver a todos los artículos
    tutorial2026-11-117 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.

    ToAPIs Engineering & Evaluation Team
    MiniMax HailuoVideo APIHuman MotionImage-to-VideoTutorial
    TL;DR - Puntos clave
    • Usa la cadena de modelo del catálogo MiniMax-Hailuo-2.3 para texto a vídeo y para imagen a vídeo con primer fotograma; MiniMax-Hailuo-2.3-Fast solo admite imagen a vídeo.
    • El contrato actual permite duraciones de 6 o 10 segundos y resoluciones 768P o 1080P; 1080P solo admite 6 segundos, y el prompt está limitado a 2.000 caracteres.
    • Las directivas de cámara documentadas, como [Push in], van dentro del texto del prompt y no como campos separados de la API. Hailuo 2.3 no tiene entrada de último fotograma.
    • Guarda el id de la tarea, consulta GET /v1/videos/generations/{id} y confirma el precio actual de tu cuenta: no reutilices una tarifa por segundo sin verificar.

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

    Modelo objetivo: MiniMax-Hailuo-2.3
    Endpoint de inferencia: https://api.toapis.com/v1/videos/generations
    Relacionado: Guía de la API de MiniMax H3 · Prompts de movimiento de cámara de H3 · Pipeline R2V automatizado


    1. Resumen y panorama del rendimiento

    • Trabajo: enviar trabajos de texto a vídeo o de imagen a vídeo con primer fotograma para clips de personajes y de movimiento humano al endpoint de generaciones de ToAPIs.
    • Contrato: MiniMax-Hailuo-2.3 acepta duraciones enteras de 6 o 10 segundos y resoluciones 768P o 1080P. 1080P solo admite 6 segundos. La referencia actual de la API limita el prompt a 2.000 caracteres.
    • ID: usa la cadena del catálogo MiniMax-Hailuo-2.3 (texto a vídeo e imagen a vídeo). MiniMax-Hailuo-2.3-Fast es solo imagen a vídeo y exige una URL de primer fotograma. Ninguno de los dos ID es intercambiable con minimax-h3.
    • Lenguaje de cámara: la referencia de Hailuo 2.3 de ToAPIs documenta directivas entre corchetes como [Push in] y [Pan left, Pedestal up]. Trata la tabla de abajo como el vocabulario documentado actual y confírmalo con la documentación vigente antes de fijar por código una gramática de planos.
    • Protocolo: REST con Bearer. Guarda el id de la tarea del formato de respuesta y consulta GET /v1/videos/generations/{task_id} (o GET /v1/tasks/{task_id}) con un plazo acotado. Un tiempo de espera agotado en el cliente no demuestra que la tarea upstream haya fallado.

    2. Patrones de prompt para movimiento humano

    El catálogo público de ToAPIs describe MiniMax Hailuo 2.3 como un modelo de vídeo para movimiento de personajes, expresiones y estilo en historias expresivas y clips de personajes. Ese es posicionamiento de producto, no una comparativa independiente de «cero deformación de extremidades». Para trabajo de producción, escribe prompts que describan un sujeto y una acción principal con lenguaje mecánico claro y luego revisa la toma.

    Un prompt útil de movimiento humano nombra la mecánica corporal antes de añadir estilo: quién se mueve, qué extremidad lidera, cómo se desplaza el peso y cómo empieza y termina la acción. Mantén ese núcleo estable cuando hagas pruebas A/B de duración o de resolución; de lo contrario, un cambio de redacción puede explicar una toma distinta.

    La referencia de la API de Hailuo 2.3 de ToAPIs documenta las directivas de cámara de abajo. Van dentro de la cadena del prompt, no en un campo de la solicitud aparte. El contrato de solicitud del frontend sigue validando prompt como texto. Combina como máximo tres directivas en un mismo corchete para movimiento simultáneo, o secuéncialas en la frase para movimientos ordenados.

    CategoríaDirectivas documentadas
    Paneo[Pan left], [Pan right]
    Inclinación[Tilt up], [Tilt down]
    Push / Pull[Push in], [Pull out]
    Pedestal[Pedestal up], [Pedestal down]
    Truck[Truck left], [Truck right]
    Zoom[Zoom in], [Zoom out]
    Otros[Shake], [Tracking shot], [Static shot]

    Gráfico abstracto de poses de primer fotograma que entra en la pasarela de ToAPIs y se ramifica en tomas de movimiento

    Figura 1: trata una pose fija como entrada de primer fotograma, describe la acción posterior en el prompt y envía una sola solicitud de generación a través de la pasarela de ToAPIs.

    Una plantilla compacta que sigue siendo comprobable:

    text
    SUBJECT and PRIMARY ACTION (lead limb, weight shift, follow-through), ENVIRONMENT, [CAMERA], STYLE NOTES
    

    Ejemplo: A contemporary dancer in a black practice leotard plants the left foot, then uncoils a slow 360-degree turn with the right arm leading and the torso stacked over the standing leg, warehouse skylight, [Tracking shot], photorealistic, no morphing limbs.

    Para imagen a vídeo, envía una URL de primer fotograma accesible públicamente en image_urls. La imagen es el fotograma inicial; el prompt describe el movimiento que sigue. Los límites de imagen documentados actualmente son JPG, JPEG, PNG o WebP; menos de 20 MB; lado corto mayor de 300 px; y una relación de aspecto entre 2:5 y 5:2. No pongas base64 en image_urls: sube primero un archivo local.

    MiniMax-Hailuo-2.3-Fast no acepta texto a vídeo: se exige una URL de primer fotograma. Hailuo 2.3 no documenta un campo de último fotograma; la interpolación de primer a último fotograma corresponde a MiniMax-Hailuo-02, no a este ID. No copies campos de H3 como ratio o reference_videos en una solicitud de Hailuo 2.3.

    Las etiquetas de las opciones del Playground pueden mostrar 768p / 1080p en minúsculas. Los ejemplos actuales de la API usan 768P y 1080P. Confirma el valor que acepta tu cuenta antes de automatizar un lote. La misma redacción de cámara se puede reutilizar cuando pases un plano a MiniMax H3, pero los contratos de duración, resolución y modo de medios son diferentes: cambia de ID solo después de releer esa guía.


    3. Implementación en producción: cURL y Python

    Paso 1: envío con cURL

    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-Hailuo-2.3",
        "prompt": "A contemporary dancer in a black practice leotard plants the left foot, then uncoils a slow 360-degree turn with the right arm leading and the torso stacked over the standing leg, warehouse skylight, [Tracking shot], photorealistic, no morphing limbs",
        "duration": 6,
        "resolution": "768P"
      }'
    

    Paso 2: ayuda y sondeo en Python

    La documentación oficial registra actualmente el origen público https://toapis.com (y https://toapis.cn para China continental). Otras guías de ToAPIs de esta serie usan https://api.toapis.com. Elige una URL base y mantenla coherente. El fragmento de abajo sigue la ruta de estado de tarea documentada y los estados completed / failed; confirma id, result.data[0].url y el formato de respuesta con la referencia de la API de tu cuenta antes de publicar.

    python
    import os
    import time
    import requests
    
    API_KEY = os.environ["TOAPIS_API_KEY"]
    BASE = "https://api.toapis.com"
    ENDPOINT = f"{BASE}/v1/videos/generations"
    HEADERS = {
        "Authorization": f"Bearer {API_KEY}",
        "Content-Type": "application/json",
    }
    
    
    def dispatch_motion_clip(
        prompt: str,
        duration: int = 6,
        resolution: str = "768P",
        image_url: str | None = None,
        model: str = "MiniMax-Hailuo-2.3",
    ) -> str:
        if resolution == "1080P" and duration != 6:
            raise ValueError("1080P currently supports a 6-second duration only")
        payload = {
            "model": model,
            "prompt": prompt,
            "duration": duration,
            "resolution": resolution,
            "metadata": {"prompt_optimizer": True, "aigc_watermark": False},
        }
        if image_url:
            payload["image_urls"] = [image_url]
        elif model == "MiniMax-Hailuo-2.3-Fast":
            raise ValueError("MiniMax-Hailuo-2.3-Fast requires a first-frame image_urls value")
        res = requests.post(ENDPOINT, headers=HEADERS, json=payload, timeout=30)
        res.raise_for_status()
        data = res.json()
        task_id = data.get("id") or data.get("task_id")
        if not task_id:
            raise RuntimeError(f"Unexpected submission envelope: {data}")
        return task_id
    
    
    def poll_task(task_id: str, deadline_s: int = 300) -> str:
        poll_url = f"{BASE}/v1/videos/generations/{task_id}"
        interval = 5.0
        start = time.time()
        while time.time() - start < deadline_s:
            time.sleep(interval)
            poll = requests.get(poll_url, headers=HEADERS, timeout=15)
            if poll.status_code == 429:
                retry_after = poll.headers.get("Retry-After")
                time.sleep(float(retry_after) if retry_after else min(interval * 2, 30))
                continue
            poll.raise_for_status()
            data = poll.json()
            status = data.get("status")
            if status == "completed":
                return data["result"]["data"][0]["url"]
            if status == "failed":
                raise RuntimeError(f"Generation failed: {data.get('error')}")
            interval = min(interval * 1.5, 10.0)
        raise TimeoutError(f"Task {task_id} exceeded {deadline_s}s; check status before retrying")
    
    
    if __name__ == "__main__":
        prompt = (
            "A contemporary dancer in a black practice leotard plants the left foot, "
            "then uncoils a slow 360-degree turn with the right arm leading and the "
            "torso stacked over the standing leg, warehouse skylight, [Tracking shot], "
            "photorealistic, no morphing limbs"
        )
        task_id = dispatch_motion_clip(prompt)
        print("Task:", task_id)
        print("Video:", poll_task(task_id))
    

    Guarda la versión de la plantilla de prompt junto al registro de la tarea para poder distinguir un cambio de modelo de un cambio de redacción. Si necesitas un trabajo con primer fotograma, pasa image_url= a dispatch_motion_clip. Para la SKU Fast, ese argumento es obligatorio.

    La duración de Hailuo 2.3 base es de 6 o 10 segundos. No envíes 1080P con duration: 10. Si necesitas clips continuos de 4 a 15 segundos, material de referencia o entradas de último fotograma, ese es otro contrato: consulta la guía de la API de H3 y el tutorial del pipeline R2V.


    4. Gestión de errores y matriz de estados

    Las categorías de abajo son puntos de partida para el diagnóstico, no una garantía de los códigos de error exactos de ToAPIs. Una consulta HTTP correcta sigue exigiendo leer el status de la tarea.

    Estado HTTPCategoría habitualAcción recomendada
    400Campo inválido, combinación no admitida o conflicto de modo de mediosRevisa el ID de modelo exacto, que la duración sea 6 o 10, que 1080P se combine solo con 6 segundos y que los trabajos Fast incluyan image_urls. No envíes un campo de último fotograma en Hailuo 2.3
    401Clave de API ausente o inválidaRota la clave en el panel de ToAPIs y confirma la cabecera Authorization
    429Límite de frecuencia o de concurrenciaRespeta Retry-After cuando esté presente; retrocede con fluctuación aleatoria; 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

    WaitTime=min⁡(MaxWait,BaseInterval×2attempt)+Uniform(0,1)\text{WaitTime} = \min(\text{MaxWait}, \text{BaseInterval} \times 2^{\text{attempt}}) + \text{Uniform}(0, 1)WaitTime=min(MaxWait,BaseInterval×2attempt)+Uniform(0,1)


    5. Precios y retorno de FinOps

    Estimated cost=successful billable jobs×current account rate for that model, duration, and resolution\text{Estimated cost} = \text{successful billable jobs} \times \text{current account rate for that model, duration, and resolution}Estimated cost=successful billable jobs×current account rate for that model, duration, and resolution

    • No reutilices precios unitarios de borradores de planificación. Las tarifas por segundo o por vídeo, las unidades de facturación y el tratamiento de tareas fallidas varían según el modelo, la resolución, la duración, la ruta y la cuenta. Las filas de referencia oficiales del proveedor en la página de precios de ToAPIs son solo informativas y pueden no coincidir con lo que se factura a tu cuenta. Lee el catálogo actual y la cotización de tu cuenta antes de prever una lista de planos.
    • Fast es una SKU distinta, no un interruptor de velocidad gratuito sobre el mismo ID. MiniMax-Hailuo-2.3-Fast está documentado solo como imagen a vídeo. Confirma su precio actual de cuenta por separado.
    • Controla el gasto en la capa de prompt: haz borradores en 768P y 6 segundos, mantén una plantilla versionada, cambia una variable cada vez y no reenvíes tras un tiempo de espera agotado del cliente hasta comprobar el estado de la tarea.
    • Los contratos oficiales de los proveedores suelen añadir compromisos anuales, cuotas por usuario y mínimos de prepago. La facturación de ToAPIs suele ser pago por uso: confirma las condiciones activas de tu cuenta.

    6. Preguntas frecuentes

    Consulta el bloque de preguntas frecuentes del frontmatter. En resumen: la cadena de modelo de la solicitud es MiniMax-Hailuo-2.3, no un slug con guiones ni un ID de H3; 1080P se limita a 6 segundos; Fast exige una URL de primer fotograma y no admite texto a vídeo; las directivas de cámara documentadas van en el prompt, no como campos separados; Hailuo 2.3 no tiene entrada de último fotograma.


    7. Lista de acciones

    • Crea una clave en el Portal de desarrolladores de ToAPIs.
    • Haz una prueba rápida del fragmento de cURL con MiniMax-Hailuo-2.3, resolution: "768P" y una duración de 6 segundos.
    • Confirma si tu cuenta espera 768P o 768p, y consulta GET /v1/videos/generations/{id} con un plazo acotado.
    • Siguiente paso: la guía de movimiento de cámara de H3 si necesitas otra duración u otro contrato de medios, y la guía del modelo Hailuo 2.3 para el estado del catálogo en vivo.

    Explora los modelos mencionados en este artículo

    MiniMaxVIDEO

    minimax-hailuo-2.3

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

    minimax-hailuo-2.3-fast

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

    minimax-h3

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

    Artículos relacionados

    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-09T14:00:00+08:004 min de lectura

    Revisión de la API de Seedance 2.0 Mini: generación de vídeo de alto rendimiento con presupuesto ajustado

    Benchmark para desarrolladores de ByteDance Seedance 2.0 Mini: latencia inferior a 18 s, 720p nativo a 24fps y una economía de $0.012 por segundo para canales sociales y de publicidad de alta concurrencia.

    TO
    ToAPIs Engineering & Evaluation Team
    #Seedance 2.0 Mini
    tutorial2026-11-06T12:00:00+08:003 min de lectura

    Generar vídeos de IA en 4K con Seedance 2.0: buenas prácticas para prompts y parámetros

    Domina la generación de vídeo en 4K ultra alta definición con la API de ByteDance Seedance 2.0. Aprende configuraciones de parámetros, escalado de relación de aspecto, optimización de prompts y manejo de timeouts.

    TO
    ToAPIs Engineering & Evaluation Team
    #Seedance 2.0
    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.