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. Guia de prompts do MiniMax H3: como criar movimentos de câmera cinematográficos pela API
    Voltar a todos os artigos
    tutorial2026-11-106 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.

    ToAPIs Engineering & Evaluation Team
    MiniMax H3Prompting GuideCamera MovementsVideo APITutorial
    TL;DR - Principais conclusões
    • Escreva uma cena e uma ação principal e depois acrescente direção de câmera, lente e iluminação como texto comum de prompt.
    • Etiquetas entre colchetes como [Pan Left] ou [Dolly In] são auxílios úteis de prompt; o contrato do frontend da ToAPIs não as define como comandos nativos do H3.
    • O MiniMax H3 base aceita durações inteiras de 4 a 15 segundos em POST /v1/videos/generations; use o nome de campo ratio, não aspect_ratio.
    • Confirme o ID de modelo exato, o preço atual da conta e o esquema de resposta antes de automatizar uma lista de planos.

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

    Modelo alvo: minimax-h3
    Endpoint de inferência: https://api.toapis.com/v1/videos/generations
    Relacionado: Guia da API MiniMax H3 · Escolha entre H3 e Turbo · Pipeline R2V automatizado


    1. Resumo e visão geral de desempenho

    • Trabalho: transformar uma lista de planos em prompts repetíveis do MiniMax H3 (sujeito, ação, trajetória de câmera, lente e iluminação) e enviá-los ao endpoint de gerações da ToAPIs.
    • Arte do prompt: comece pela intenção de câmera e depois pelo sujeito. Combine uma frase direcional com uma distância focal (por exemplo 35 mm versus 85 mm) e uma indicação de iluminação.
    • Contrato: o minimax-h3 base aceita clipes inteiros de 4–15 s. Use ratio (16:9, 9:16 e as outras proporções listadas abaixo). Este é o contrato de requisição do frontend, não um benchmark de latência ou de qualidade.
    • Cuidado com a sintaxe: etiquetas entre colchetes são auxílios de prompt. Não trate [Pan Left] como comando nativo documentado, a menos que a documentação do modelo upstream diga isso.
    • Protocolo: REST com Bearer. Envie uma única vez, guarde o identificador da tarefa e consulte o endpoint de status documentado com um prazo limitado.

    2. Padrões de prompt para movimentos de câmera

    Um prompt útil para o H3 descreve uma cena e uma ação principal antes de acrescentar direção de câmera, lente ou estilo. Mantenha essas partes estáveis quando fizer um teste A/B de modelo ou de duração; caso contrário, uma mudança de redação pode explicar uma tomada diferente.

    As etiquetas da tabela abaixo são auxílios de prompt, não uma gramática de comandos garantida. O contrato do frontend da ToAPIs valida o prompt como texto (até 7.000 caracteres Unicode). Ele não confirma que strings como [Pan Left] sejam comandos nativos do H3. Use-as como vocabulário consistente nos seus modelos e depois revise a saída.

    Auxílio de promptTrajetória visualUso típico
    [Pan Left] / [Pan Right]Rotação horizontal em um eixo fixoRevelações de paisagem, varreduras de horizonte urbano
    [Tilt Up] / [Tilt Down]Inclinação vertical a partir de uma posição fixaTorres, sujeitos altos, revelações de céu
    [Dolly In] / [Dolly Out]A câmera se aproxima ou se afasta do sujeitoReforçar a ênfase emocional
    [Truck Left] / [Truck Right]Movimento lateral de acompanhamentoSeguir ao lado de um veículo ou de alguém andando
    [Crane Shot] / [Pedestal Up]Elevação vertical da câmeraPlanos gerais em ângulo alto
    [Orbit 180] / [Arc Shot]Movimento semicircular ao redor do sujeitoGiro de produto, revelação de herói
    [Hitchcock Zoom]Dolly in enquanto faz zoom out (ou o contrário)Choque psicológico, percepção súbita

    Trajetórias de câmera abstratas ao redor de um nó de sujeito

    Figura 1: trate pan, tilt, dolly e órbita como trajetórias no espaço do prompt ao redor de um sujeito e depois envie uma única requisição de geração pelo gateway da ToAPIs.

    Um modelo compacto que continua testável:

    text
    [CAMERA] SUBJECT and ACTION, LIGHTING, shot on LENS, STYLE NOTES
    

    Exemplo: [Orbit 180 + Slow Dolly In] Matte black mechanical wristwatch resting on volcanic stone, moody low-key rim lighting, subtle steam haze, shot on 85mm macro lens, photorealistic, cinematic motion blur.

    Para trabalhos de primeiro quadro (R2V), a mesma linguagem de prompt descreve como a câmera deve se mover ao redor da imagem âncora ou se afastar dela. Consulte o tutorial do pipeline R2V para ver os campos da requisição. Entradas de quadro e mídia de referência continuam sendo modos mutuamente exclusivos.

    Os valores de ratio aceitos no frontend atual são adaptive, 21:9, 16:9, 4:3, 1:1, 3:4 e 9:16. Entradas de quadro forçam adaptive. Não envie aspect_ratio; o campo do contrato é ratio.


    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-h3",
        "prompt": "[Orbit 180 + Slow Dolly In] Matte black mechanical wristwatch resting on volcanic stone, moody low-key rim lighting, subtle steam haze, shot on 85mm macro lens, photorealistic, cinematic motion blur",
        "duration": 6,
        "ratio": "16:9"
      }'
    

    Passo 2: auxílio de prompt e sondagem em Python

    Ajuste os nomes de campo e o envelope de resposta à referência da API da sua conta. O trecho abaixo usa o caminho de status de tarefa que também aparece em outros guias de vídeo da ToAPIs; confirme task_id, status e video_url contra esse esquema antes de publicar.

    python
    import os
    import time
    import requests
    
    API_KEY = os.environ["TOAPIS_API_KEY"]
    ENDPOINT = "https://api.toapis.com/v1/videos/generations"
    HEADERS = {
        "Authorization": f"Bearer {API_KEY}",
        "Content-Type": "application/json",
    }
    
    
    def build_cinematic_prompt(
        subject: str,
        camera_move: str,
        lighting: str,
        lens: str = "35mm anamorphic",
    ) -> str:
        return (
            f"[{camera_move}] {subject}, {lighting}, "
            f"shot on {lens}, photorealistic, cinematic motion blur."
        )
    
    
    def dispatch_camera_shot(prompt: str, duration: int = 6, ratio: str = "16:9") -> str:
        payload = {
            "model": "minimax-h3",
            "prompt": prompt,
            "duration": duration,
            "ratio": ratio,
        }
        res = requests.post(ENDPOINT, headers=HEADERS, json=payload, timeout=30)
        res.raise_for_status()
        data = res.json()
        task_id = data.get("task_id") or data.get("id")
        if not task_id:
            raise RuntimeError(f"Unexpected submission envelope: {data}")
        return task_id
    
    
    def poll_task(task_id: str, deadline_s: int = 180) -> str:
        poll_url = f"https://api.toapis.com/v1/videos/tasks/{task_id}"
        interval = 3.0
        start = time.time()
        while time.time() - start < deadline_s:
            time.sleep(interval)
            poll = requests.get(poll_url, headers=HEADERS, timeout=15)
            poll.raise_for_status()
            data = poll.json()
            status = data.get("status")
            if status in {"succeeded", "success"}:
                return data["video_url"]
            if status in {"failed", "error"}:
                raise RuntimeError(f"Generation failed: {data.get('error')}")
            interval = min(interval * 1.5, 8.0)
        raise TimeoutError(f"Task {task_id} exceeded {deadline_s}s; check status before retrying")
    
    
    if __name__ == "__main__":
        prompt = build_cinematic_prompt(
            subject="Matte black mechanical wristwatch resting on volcanic stone",
            camera_move="Orbit 180 + Slow Dolly In",
            lighting="Moody low-key rim lighting, subtle steam haze",
            lens="85mm macro lens",
        )
        task_id = dispatch_camera_shot(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 distinguir uma mudança de modelo de uma mudança de redação. Um tempo esgotado no lado do cliente não prova que a tarefa upstream falhou; verifique o status antes de enviar um segundo trabalho faturável.

    A duração do H3 base é um inteiro de 4 a 15 segundos. Os IDs da família Max começam em 5 segundos e têm suas próprias listas de resolução; o Turbo não aceita mídia de referência. Consulte o guia da API antes de trocar de ID.


    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.

    Status HTTPCategoria comumAção recomendada
    400Campo inválido, valor não aceito ou conflito de modo de mídiaVerifique o ID de modelo, a duração, o ratio, a resolução e se entradas de quadro não estão misturadas com mídia de referência
    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ênciaRecue 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 output seconds×current account rate per second\text{Estimated cost} = \text{successful output seconds} \times \text{current account rate per second}Estimated cost=successful output seconds×current account rate per second

    • Não reutilize preços unitários de rascunhos de planejamento. Tarifas por segundo, unidades de cobrança e tratamento de tarefas com falha variam por modelo, rota e conta. Leia o catálogo atual da ToAPIs e a cotação da sua conta antes de prever uma lista de planos.
    • 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 na sua conta.
    • Controle o gasto na camada de prompt: mantenha um modelo versionado, mude uma variável por vez e evite reenviar depois de um tempo esgotado no cliente até verificar o status da tarefa.
    • Para pesar variantes (H3 base, Max canônico, Turbo), use o guia de escolha em vez de uma pontuação de velocidade ou de qualidade não verificada.

    6. Perguntas frequentes

    Consulte o bloco de perguntas frequentes do frontmatter. Em resumo: coloque a intenção de câmera no início do prompt; a linguagem de câmera composta é texto de prompt, não uma gramática garantida; a mesma redação se aplica no modo de primeiro quadro; etiquetas entre colchetes não são parâmetros oficiais da API.


    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-h3, ratio: "16:9" e duração de 6 segundos.
    • Adote o auxílio de prompt, guarde as versões do modelo e consulte com um prazo de 180 s.
    • Próximo passo: o contrato de requisição da API do H3 e o pipeline R2V automatizado.

    Explore os modelos mencionados neste artigo

    MiniMaxVIDEO

    minimax-h3

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

    minimax-h3-max

    Taxa atual: 8 credits /second
    Guia do modeloTestar no consoleObter chave de API
    ToAPIsAI Model

    minimax-h3-max-turbo

    Taxa atual: Ver preços em tempo real
    Guia do modeloTestar no consoleObter chave de API

    Artigos relacionados

    tutorial2026-11-11T10:00:00+08:007 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.

    TO
    ToAPIs Engineering & Evaluation Team
    #MiniMax Hailuo
    tutorial2026-11-10T14:00:00+08:006 min de leitura

    Como criar um pipeline automatizado de imagem para vídeo (R2V) com a API MiniMax H3

    Tutorial de engenharia para um pipeline automatizado de Reference-to-Video no MiniMax H3: entradas de primeiro quadro, preparação de recursos, sondagem limitada de tarefas e o contrato de requisição do frontend da ToAPIs.

    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
    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.