API do Magnific Video Upscaler: preços e como funciona

Fazer upscaling de um vídeo é caro de um jeito que o upscaling de imagens nunca é. Um clipe de 60 segundos a 24 quadros por segundo tem 1.440 imagens separadas, e cada uma delas é cobrada. Esse fato explica quase tudo sobre como o Magnific video upscaler API é precificado, e por que um teste rápido em um clipe curto parece barato enquanto um lote grande não parece. Este artigo mostra como a API funciona, o que cada parâmetro faz com seu material, quanto as tarifas por quadro somam e o que usar quando uma integração via API dá mais trabalho do que o job merece.

O que o Magnific Video Upscaler faz

O Magnific começou como um upscaler de imagens com IA da Espanha, que ficou conhecido por acrescentar detalhes inventados a fotos suaves e de baixa resolução. A Freepik adquiriu a empresa em 2024, e hoje ela executa suas ferramentas de IA sob o nome Magnific, com a documentação para desenvolvedores em docs.magnific.com. O video upscaler aplica a mesma ideia a imagens em movimento: você envia um clipe, escolhe uma resolução de destino de até 4K e recebe de volta um arquivo mais nítido, com detalhes reconstruídos.

Este é um serviço hospedado e assíncrono. Você nunca roda um modelo por conta própria. Envia uma tarefa, espera e coleta uma URL. Isso facilita integrar o serviço a um app, a uma fila de renderização ou a uma ferramenta de automação, e também significa que todas as decisões de qualidade passam por um punhado de parâmetros numéricos.

Modos Creative e Precision

O Magnific oferece dois tipos de upscaling de vídeo, e escolher o certo importa mais do que qualquer controle deslizante.

O upscaler creative pode inventar textura, o que ajuda quando a origem está borrada. O upscaler precision traz o resultado de volta em direção ao original pela configuração strength, então rostos, logos e padrões finos ficam mais próximos do que foi filmado. A página de visão geral também lista uma rota turbo separada para um processamento mais rápido, e os limites de requisições são compartilhados entre os endpoints padrão e turbo.

Quem realmente precisa disso

• Estúdios de restauração que levam fitas antigas e clipes de celular antigos para telas modernas
• Equipes de produto que querem vídeos de demonstração em 4K a partir de gravações de tela em 1080p
• Desenvolvedores que integram o upscaling a um app que reage a webhooks
• Agências que enviam dezenas de clipes para redes sociais com as mesmas configurações toda semana

Se você não se encaixa em nenhum desses grupos, pule para a seção sobre quando a API é exagero.

Como a API funciona, passo a passo

O fluxo inteiro tem três etapas: criar uma tarefa, esperar por ela e buscar o resultado. Nada é transmitido em fluxo contínuo, e nada trava enquanto o upscaling roda.

Autenticação e a primeira requisição

Cada chamada leva uma única credencial de API em um cabeçalho personalizado da requisição. O nome exato do cabeçalho aparece no topo de cada página de endpoint na documentação, então copie de lá em vez de chutar. O único campo obrigatório no corpo é video, uma URL HTTPS publicamente acessível que aponta diretamente para o arquivo.

{
  "video": "https://example.com/clips/harbour-720p.mp4",
  "resolution": "4k",
  "creativity": 20,
  "sharpen": 15,
  "smart_grain": 5,
  "flavor": "natural",
  "fps_boost": false,
  "output_format": "h264",
  "webhook_url": "https://example.com/hooks/upscale-finished"
}

Copiar prompt

Uma chamada bem-sucedida retorna 200 com um pequeno envelope:

{
  "data": {
    "task_id": "00000000-0000-0000-0000-000000000000",
    "status": "CREATED",
    "generated": []
  }
}

Copiar prompt

As falhas voltam como 400 para problemas de validação, 401 para uma credencial ausente ou inválida, e 500 ou 503 quando o próprio serviço está com dificuldades.

Polling e webhooks

Você tem duas formas de saber que uma tarefa terminou. Consulte GET /v1/ai/video-upscaler/{task-id} até o status mudar, ou informe um webhook_url e deixe o Magnific chamar você. Uma tarefa passa de CREATED para IN_PROGRESS e termina em FAILED ou em um estado final de sucesso, momento em que o array generated traz as URLs de saída. Um GET em /v1/ai/video-upscaler lista suas tarefas, o que é útil depois de uma queda, quando você precisa encontrar tarefas que perdeu de vista.

💡 Dica: Salve o task_id no momento em que o receber e copie os arquivos finalizados para o seu próprio armazenamento imediatamente. Trate as URLs devolvidas como temporárias, até que a documentação diga o contrário.

Para um punhado de clipes, o polling com intervalo crescente funciona bem. Para lotes, os webhooks economizam um laço de repetição e muitas requisições desperdiçadas.

Regras de entrada que costumam dar problema

• A URL precisa ser HTTPS e pública. Se você usar um link pré-assinado, garanta que ele continue válido por tempo suficiente para o Magnific baixar o arquivo.
• A documentação não publica limites de duração, tamanho de arquivo ou formato de contêiner, então teste seu clipe mais longo e mais pesado antes de montar um pipeline em cima do serviço.
• Uma origem mal comprimida ainda limita o resultado. O upscaling pode inventar textura, mas não consegue trazer de volta um rosto que o codificador já borrou.

Todos os parâmetros em linguagem simples

Nove configurações moldam a saída. A maioria delas tem zero ou desligado como padrão, o que significa que uma requisição simples gera um resultado limpo e conservador em 2K.

Creativity, Sharpen e Smart Grain

Creativity é o controle que separa um upscaling fiel de um repintado. Em 0, o modelo se mantém cauteloso. Valores mais altos acrescentam textura, o que favorece paisagens e tecidos, mas pode alterar rostos. Um ponto de partida razoável fica entre 0 e 25 para pessoas, e mais alto para cenários ou material antigo com pouco detalhe restante.

Sharpen deve ficar baixo. Empurrado demais, ele produz halos ao redor das bordas que parecem piores do que o borrão que substituíram. Smart grain acrescenta granulação de filme por cima, e uma pequena quantidade (digamos de 5 a 10) é uma forma barata de esconder o aspecto plástico que upscalings muito limpos às vezes apresentam.

Flavor e FPS boost

Flavor tem duas opções. Trate vivid como o visual mais marcante e natural como o mais contido, e rode as duas no mesmo clipe de três segundos antes de se comprometer com um lote inteiro.

FPS boost aumenta a taxa de quadros para um movimento mais suave, e isso tem uma consequência na cobrança, explicada abaixo. No endpoint precision, a documentação informa que strength é ignorado quando fps_boost está ativado, e o upscaling completo é aplicado.

Saída em H.264 ou ProRes

O padrão h264 retorna um MP4 comum. Escolha prores_422_hq quando o arquivo for para uma linha do tempo de correção de cor ou edição: você recebe uma prévia em H.264 mais um arquivo .mov em ProRes 422 HQ. Arquivos ProRes são grandes, então planeje o armazenamento e o tempo de transferência antes de ativar a opção em um clipe longo.

O custo real do upscaling

A documentação do Magnific descreve uma precificação por quadro que varia com a resolução de saída, e direciona você para a página de preços para ver os números. As tarifas públicas por quadro mais claras vêm da página de preços da API da Runway, que lista o upscaler de vídeo creative do Magnific. Use-as como referência e confirme na página do próprio Magnific antes de comprometer um orçamento.

Matemática da precificação por quadro

A fórmula é simples: custo = quadros x tarifa, em que quadros equivalem a quadros por segundo vezes a duração em segundos.

A Runway converte dólares em créditos à razão de um centavo por crédito e arredonda para cima, com um mínimo de um crédito por geração. Observe o formato da curva: 4K custa cerca de 33% a mais por quadro do que 2K e cerca de 71% a mais do que 720p. O salto de 720p para 4K não é dramático por quadro, mas em milhares de quadros ele se acumula.

Três exemplos calculados

Levando isso para um lote: 100 clipes de 15 segundos a 30 fps são 45.000 quadros, o que dá US$ 405 em 2K ou US$ 540 em 4K. Esse é o número para conferir antes de automatizar qualquer coisa.

Multiplicadores ocultos que merecem atenção

• FPS boost altera a contagem de quadros de saída, então a cobrança segue a nova contagem, e não a do seu material de entrada.
• No endpoint precision, a documentação diz que contas B2B veem a contagem de quadros cobrada em um cabeçalho de resposta X-Frames-Billed, com um mínimo de 12 quadros e um multiplicador de 1,60x quando fps_boost está ativo.
• A resolução padrão é 2K, então uma requisição sem resolution é cobrada pela tarifa de 2K, mesmo que você só precisasse de 720p.

💡 Dica: Rode cada nova origem por um clipe de teste de 3 a 5 segundos na resolução que você pretende entregar. Custa centavos e mostra o visual real antes da conta real.

Limites de requisições e planejamento de produção

A vazão é a segunda restrição, depois do preço. Segundo a documentação, o plano gratuito permite 10 requisições por dia e o Tier 1 permite 125 requisições por dia, compartilhadas entre os endpoints padrão e turbo. Qualquer valor acima disso é negociado diretamente com o Magnific.

Esses números moldam seu planejamento mais do que o preço. No Tier 1, um lote de 100 clipes cabe em um único dia, enquanto 500 clipes levam quatro dias, a menos que seu limite aumente. Um pipeline robusto costuma fazer cinco coisas:

1. Armazena cada task_id em um banco de dados antes de fazer qualquer outra coisa
2. Envia os clipes até o limite diário de requisições e enfileira o restante
3. Usa webhooks para os resultados, com um job de polling lento como rede de segurança
4. Refaz as tarefas FAILED com um atraso, e limita o número de tentativas
5. Registra os quadros cobrados por tarefa para que as faturas possam ser conferidas

Quando a API é exagero

A API é a ferramenta certa quando o upscaling é um recurso do seu produto ou um trabalho recorrente. Ela é a ferramenta errada para um clipe único numa tarde de terça-feira.

O custo de configuração é o item oculto da conta. Hospedar a origem em um endereço HTTPS público, lidar com falhas e armazenar os resultados pode levar mais tempo do que o próprio upscaling em um job pequeno.

Como usar o Video Upscale no PicassoIA

Para clipes avulsos, o Video Upscale no PicassoIA roda no navegador, sem credenciais, sem hospedagem pública e sem polling. Ele recebe três entradas: video (obrigatório), target_resolution (720p, 1080p ou 4k, padrão 4k) e target_fps (15 a 120, padrão 30).

Configurações passo a passo

1. Abra a página do modelo Video Upscale e envie seu clipe.
2. Defina target_resolution. Escolha 4k para material de arquivo e telas grandes, ou 1080p quando o clipe for para feeds de redes sociais.
3. Defina target_fps. Mantenha igual à origem para um ganho puro de nitidez, ou eleve material de 30 fps para 60 para uma ação mais suave.
4. Execute o modelo e baixe o resultado sem marca d’água.
5. Compare um quadro da saída com o original em tela cheia antes de publicar.

O modelo reconstrói detalhes finos em vez de esticar pixels e interpola quadros na mesma passagem, então uma execução cuida tanto da resolução quanto da suavidade do movimento.

Runway Upscale v1 para clipes curtos

O Upscale v1 da Runway recebe uma única entrada e amplia o clipe 4x, até 4K. Seus limites são claros: os vídeos precisam ter menos de 40 segundos, menos de 4096 pixels em cada lado e menos de 16 MB. Isso serve bem para reels, promos e demos, inclusive clipes gerados com o Veo 3.1 ou o Seedance 2.0. Para quadros fixos, o Topaz Image Upscale cuida de ampliações de até 6x.

Esses são motores diferentes do Magnific, então os resultados não vão coincidir quadro a quadro. Rode o mesmo clipe em cada um e julgue com os próprios olhos.

Teste com o seu próprio material

O melhor teste não custa nada: pegue o clipe mais suave do seu drive, passe pelo Video Upscale no Picasso IA em 4k e coloque o resultado ao lado do original em um player de tela cheia. Se a diferença te convencer, transforme isso em hábito. Se você precisar do clipe em um pipeline de app, vai saber exatamente o que pedir à API.

Navegue pelo catálogo completo em picassoia.com/en/all-models, teste os dois upscalers em um clipe que importa para você e veja quanto do material antigo que você achava perdido pode voltar.