ToAPIs
    InícioToAPIs
    Geração de imagensGPT Image 2.6, Gemini, FLUX…Geração de vídeoSeedance, Veo, Kling, Sora…Chat e escritaGPT-5.6, Claude, DeepSeek…Voz e músicaLocuções, TTS, áudio
    NovidadeSeedance 2.5
    PreçosDocumentação da APIMCP
    BlogAlternativas
    EntrarComece grátis
    Todos os modelosPreçosDocumentação da APIMCPBlogAlternativas
    EntrarComece grátis

    Idioma

    Esc
    • Seedance 2.5Geração de vídeo
    • GPT Image 2Geração de imagens
    • GPT Image 2.6Geração de imagens
    • GPT Image 2.5Geração de imagens
    • Veo 3.1 FastGeração de vídeo
    • Kling 3.0 TurboGeração de vídeo
    • Kling V4 FlashGeração de vídeo
    • Grok Video 1.5Geração de vídeo
    • Nano Banana 2Geração de imagens
    • Seedream 5.5Geração de imagens
    • FLUXGeração de imagens
    • Sora 2Geração de vídeo
    • Todos os modelos de imagemCategoria
    • Todos os modelos de vídeoCategoria
    • GPT-5.6 SolChat e código
    • Claude Opus 4.8Chat e código
    • Claude Opus 4.7Chat e código
    • DeepSeek V4 ProDeepSeek · Texto
    • Gemini Omni 1.1 FlashGoogle · Multimodal
    1. Início
    2. Blog
    3. Tutorial
    4. Integração da API MiniMax Hailuo 2.3: gerar movimento humano complexo em vídeo com IA
    Voltar a todos os artigos
    tutorial2026-11-117 min de leitura

    Integração da API MiniMax Hailuo 2.3: gerar movimento humano complexo em vídeo com IA

    Guia para desenvolvedores sobre a API de vídeo MiniMax Hailuo 2.3 na ToAPIs: padrões de prompt para movimento humano, o contrato atual de requisição para trabalhos de 6 e 10 segundos em 768P e 1080P, e exemplos em cURL e Python.

    ToAPIs Engineering & Evaluation Team
    MiniMax HailuoVideo APIHuman MotionImage-to-VideoTutorial
    TL;DR - Principais conclusões
    • Use a string de modelo do catálogo MiniMax-Hailuo-2.3 para texto para vídeo e para imagem para vídeo com primeiro quadro; MiniMax-Hailuo-2.3-Fast é apenas imagem para vídeo.
    • O contrato atual permite durações de 6 ou 10 segundos e resoluções 768P ou 1080P; 1080P aceita apenas 6 segundos, e o prompt é limitado a 2.000 caracteres.
    • As diretivas de câmera documentadas, como [Push in], ficam no texto do prompt e não em campos separados da API. O Hailuo 2.3 não tem entrada de último quadro.
    • Guarde o id da tarefa, consulte GET /v1/videos/generations/{id} e confirme o preço atual da conta: não reutilize uma tarifa por segundo não verificada.

    Integração da API MiniMax Hailuo 2.3: gerar movimento humano complexo em vídeo com IA

    Modelo alvo: MiniMax-Hailuo-2.3
    Endpoint de inferência: https://api.toapis.com/v1/videos/generations
    Relacionado: Guia da API MiniMax H3 · Prompts de movimento de câmera do H3 · Pipeline R2V automatizado


    1. Resumo e visão geral de desempenho

    • Trabalho: enviar tarefas de texto para vídeo ou de imagem para vídeo com primeiro quadro para clipes de personagens e de movimento humano ao endpoint de gerações da ToAPIs.
    • Contrato: MiniMax-Hailuo-2.3 aceita durações inteiras de 6 ou 10 segundos e resoluções 768P ou 1080P. 1080P aceita apenas 6 segundos. A referência atual da API limita o prompt a 2.000 caracteres.
    • IDs: use a string do catálogo MiniMax-Hailuo-2.3 (texto para vídeo e imagem para vídeo). MiniMax-Hailuo-2.3-Fast é apenas imagem para vídeo e exige uma URL de primeiro quadro. Nenhum dos dois IDs é intercambiável com minimax-h3.
    • Linguagem de câmera: a referência do Hailuo 2.3 da ToAPIs documenta diretivas entre colchetes como [Push in] e [Pan left, Pedestal up]. Trate a tabela abaixo como o vocabulário documentado atual e confirme com a documentação vigente antes de fixar em código uma gramática de planos.
    • Protocolo: REST com Bearer. Guarde o id da tarefa do envelope de resposta e consulte GET /v1/videos/generations/{task_id} (ou GET /v1/tasks/{task_id}) com um prazo limitado. Um tempo esgotado no cliente não prova que a tarefa upstream falhou.

    2. Padrões de prompt para movimento humano

    O catálogo público da ToAPIs descreve o MiniMax Hailuo 2.3 como um modelo de vídeo para movimento de personagens, expressões e estilo em histórias expressivas e clipes de personagens. Isso é posicionamento de produto, não um benchmark independente de “zero distorção de membros”. Para trabalho de produção, escreva prompts que descrevam um sujeito e uma ação principal com linguagem mecânica clara e depois revise a tomada.

    Um prompt útil de movimento humano nomeia a mecânica corporal antes de acrescentar estilo: quem se move, qual membro lidera, como o peso se desloca e como a ação começa e termina. Mantenha esse núcleo estável quando fizer testes A/B de duração ou de resolução; caso contrário, uma mudança de redação pode explicar uma tomada diferente.

    A referência da API do Hailuo 2.3 da ToAPIs documenta as diretivas de câmera abaixo. Elas ficam dentro da string do prompt, não em um campo separado da requisição. O contrato de requisição do frontend continua validando prompt como texto. Combine no máximo três diretivas em um mesmo colchete para movimento simultâneo, ou coloque-as em sequência na frase para movimentos ordenados.

    CategoriaDiretivas documentadas
    Pan[Pan left], [Pan right]
    Tilt[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]
    Outros[Shake], [Tracking shot], [Static shot]

    Gráfico abstrato de poses de primeiro quadro entrando no gateway da ToAPIs e se ramificando em tomadas de movimento

    Figura 1: trate uma pose estática como entrada de primeiro quadro, descreva a ação seguinte no prompt e envie uma única requisição de geração pelo gateway da ToAPIs.

    Um modelo compacto que continua testável:

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

    Exemplo: 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 imagem para vídeo, envie uma URL de primeiro quadro acessível publicamente em image_urls. A imagem é o quadro inicial; o prompt descreve o movimento que vem depois. Os limites de imagem documentados atualmente são JPG, JPEG, PNG ou WebP; menos de 20 MB; lado curto maior que 300 px; e proporção entre 2:5 e 5:2. Não coloque base64 em image_urls: envie primeiro um arquivo local.

    MiniMax-Hailuo-2.3-Fast não aceita texto para vídeo: é exigida uma URL de primeiro quadro. O Hailuo 2.3 não documenta um campo de último quadro; a interpolação de primeiro para último quadro pertence ao MiniMax-Hailuo-02, não a este ID. Não copie campos do H3 como ratio ou reference_videos para uma requisição do Hailuo 2.3.

    Os rótulos das opções do Playground podem mostrar 768p / 1080p em minúsculas. Os exemplos atuais da API usam 768P e 1080P. Confirme o valor que a sua conta aceita antes de automatizar um lote. A mesma redação de câmera pode ser reutilizada quando você levar um plano para o MiniMax H3, mas os contratos de duração, resolução e modo de mídia são diferentes: troque de ID só depois de reler esse guia.


    3. Implementação em produção: cURL e Python

    Passo 1: envio com 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"
      }'
    

    Passo 2: auxílio e sondagem em Python

    A documentação oficial registra atualmente a origem pública https://toapis.com (e https://toapis.cn para a China continental). Outros guias da ToAPIs nesta série usam https://api.toapis.com. Escolha uma URL base e mantenha a coerência. O trecho abaixo segue o caminho de status de tarefa documentado e os estados completed / failed; confirme id, result.data[0].url e o envelope com a referência da API da sua conta 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))
    

    Guarde a versão do modelo de prompt junto ao registro da tarefa para poder distinguir uma mudança de modelo de uma mudança de redação. Se você precisa de uma tarefa com primeiro quadro, passe image_url= para dispatch_motion_clip. Para a SKU Fast, esse argumento é obrigatório.

    A duração do Hailuo 2.3 base é de 6 ou 10 segundos. Não envie 1080P com duration: 10. Se você precisa de clipes contínuos de 4 a 15 segundos, mídia de referência ou entradas de último quadro, esse é outro contrato: consulte o guia da API do H3 e o tutorial do pipeline R2V.


    4. Tratamento de erros e matriz de status

    As categorias abaixo são pontos de partida para diagnóstico, não uma garantia dos códigos de erro exatos da ToAPIs. Uma consulta HTTP bem-sucedida ainda exige ler o status da tarefa.

    Status HTTPCategoria comumAção recomendada
    400Campo inválido, combinação não aceita ou conflito de modo de mídiaVerifique o ID de modelo exato, se a duração é 6 ou 10, se 1080P está combinado apenas com 6 segundos e se tarefas Fast incluem image_urls. Não envie um campo de último quadro no Hailuo 2.3
    401Chave de API ausente ou inválidaRotacione a chave no painel da ToAPIs e confirme o cabeçalho Authorization
    429Limite de taxa ou de concorrênciaRespeite Retry-After quando presente; recue com variação aleatória; repita apenas quando for seguro
    5xx ou tempo esgotado na redeProblema temporário do gateway ou do upstreamVerifique o status da tarefa antes de reenviar; use uma política de repetição limitada

    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. Preços e 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

    • Não reutilize preços unitários de rascunhos de planejamento. Tarifas por segundo ou por vídeo, unidades de cobrança e tratamento de tarefas com falha variam por modelo, resolução, duração, rota e conta. As linhas de referência oficiais do fornecedor na página de preços da ToAPIs são apenas informativas e podem não corresponder ao que é cobrado da sua conta. Leia o catálogo atual e a cotação da sua conta antes de prever uma lista de planos.
    • Fast é uma SKU diferente, não um interruptor de velocidade gratuito sobre o mesmo ID. MiniMax-Hailuo-2.3-Fast está documentado apenas como imagem para vídeo. Confirme o preço atual da conta separadamente.
    • Controle o gasto na camada de prompt: faça rascunhos em 768P e 6 segundos, mantenha um modelo versionado, mude uma variável por vez e não reenvie depois de um tempo esgotado no cliente até verificar o status da tarefa.
    • Contratos oficiais de fornecedores normalmente acrescentam compromissos anuais, cotas por usuário e mínimos de pré-pagamento. A cobrança da ToAPIs costuma ser pagamento conforme o uso: confirme os termos ativos da sua conta.

    6. Perguntas frequentes

    Consulte o bloco de perguntas frequentes do frontmatter. Em resumo: a string de modelo da requisição é MiniMax-Hailuo-2.3, não um slug com hífens nem um ID do H3; 1080P é limitado a 6 segundos; Fast exige uma URL de primeiro quadro e não aceita texto para vídeo; as diretivas de câmera documentadas ficam no prompt, não em campos separados; o Hailuo 2.3 não tem entrada de último quadro.


    7. Checklist de ações

    • Crie uma chave no Portal de desenvolvedores da ToAPIs.
    • Faça um teste rápido do trecho cURL com MiniMax-Hailuo-2.3, resolution: "768P" e duração de 6 segundos.
    • Confirme se a sua conta espera 768P ou 768p e consulte GET /v1/videos/generations/{id} com um prazo limitado.
    • Próximo passo: o guia de movimento de câmera do H3 se você precisar de outra duração ou de outro contrato de mídia, e o guia do modelo Hailuo 2.3 para o estado do catálogo em produção.

    Explore os modelos mencionados neste artigo

    MiniMaxVIDEO

    minimax-hailuo-2.3

    Taxa atual: 38.8 credits /request
    Guia do modeloTestar no consoleObter chave de API
    MiniMaxVIDEO

    minimax-hailuo-2.3-fast

    Taxa atual: 27.2 credits /request
    Guia do modeloTestar no consoleObter chave de API
    MiniMaxVIDEO

    minimax-h3

    Taxa atual: 20.8 credits /second
    Guia do modeloTestar no consoleObter chave de API

    Artigos relacionados

    tutorial2026-11-10T10:00:00+08:006 min de leitura

    Guia de prompts do MiniMax H3: como criar movimentos de câmera cinematográficos pela API

    Guia para desenvolvedores sobre como escrever prompts de movimentos de câmera cinematográficos para a API de vídeo MiniMax H3 na ToAPIs: modelos reutilizáveis, exemplos em cURL e Python e o contrato de requisição atual do frontend.

    TO
    ToAPIs Engineering & Evaluation Team
    #MiniMax H3
    tutorial2026-11-09T14:00:00+08:004 min de leitura

    Análise da API Seedance 2.0 Mini: geração de vídeo de alta produtividade com orçamento apertado

    Benchmark para desenvolvedores do ByteDance Seedance 2.0 Mini: latência abaixo de 18 s, 720p nativo a 24fps e economia de $0.012 por segundo para pipelines sociais e publicitários de alta concorrência.

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

    Gerando vídeos de IA em 4K com Seedance 2.0: boas práticas para prompts e parâmetros

    Domine a geração de vídeo em 4K ultra alta definição com a API do ByteDance Seedance 2.0. Aprenda configurações de parâmetros, escala de proporção, otimização de prompts e tratamento de timeouts.

    TO
    ToAPIs Engineering & Evaluation Team
    #Seedance 2.0
    ToAPIs
    InícioToAPIs
    Gateway empresarial de API de IA. Acesse GPT-5, Claude, Gemini e mais de 200 modelos por uma única API unificada.

    Modelos populares

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

    Categorias de API

    • API de imagem com IA
    • API de vídeo com IA
    • API de texto para vídeo
    • API de imagem para vídeo
    Mostrar maisMostrar menos
    • API de edição de imagens com IA
    • API de LLM e raciocínio
    • Todas as ferramentas de API →

    Alternativas

    Alternativas
    • Alternativa ao Kie.ai
    • Alternativa ao Fal.ai
    • Alternativa ao OpenRouter
    • Alternativa ao Replicate
    • Alternativa ao Wavespeed AI
    • Todas as comparações →

    Guias em destaque

    Guias em destaque
    • Preços do Seedance 2.0 e 2.5
    • Guia da API Seedance mais barata
    • Guia de integração do MiniMax H3
    • Chave de API gratuita do Seedance 2
    • Início rápido da API Seedance 2
    • Todos os artigos técnicos →

    Desenvolvedores e plataforma

    Desenvolvedores e plataforma
    • Documentação da API
    • MCP
    • Preços
    • Playground de modelos
    • LLMs.txt
    • Falar com o suporte
    • Diretório de guias de modelos
    Entidade operadora:
    鯨樞智能科技有限公司
    JINGSHU INTELLIGENT LIMITED
    Sede social:
    ROOM 5042, 5/F, YAU LEE CENTRE, NO.45, HOI YUEN ROAD, KWUN TONG, KOWLOON, HONG KONG
    PrivacidadeTermosUso aceitávelExclusão de dadosRetenção de dadosSubprocessadores e regiõesCobrança e reembolsosPolítica de CookiesMapa do siteSobre

    © 2026 ToAPIs. Todos os direitos reservados.