A API para desenvolvedores do Freepik agora funciona sob o nome Magnific. Veja quanto o Mystic e os modelos Flux custam por imagem, segundo o que se informa, quanto o upscaler Magnific cobra por tamanho de saída, os limites de taxa documentados e um orçamento para 1.000 imagens.
A API para desenvolvedores do Freepik não ficou com esse nome por muito tempo. Desde o fim de abril de 2026, a plataforma inteira, incluindo a biblioteca de imagens e as ferramentas de IA, é vendida sob o nome Magnific, e o endereço antigo da documentação agora redireciona para docs.magnific.com. Se você está orçando uma API de geração de imagens com IA para um produto, a mudança de nome importa menos do que a tabela de preços por trás dela, porque sua conta tem duas partes bem diferentes: um gerador de imagens barato (Mystic mais uma longa lista de modelos Flux e Seedream) e um upscaler cujo preço acompanha o tamanho da saída em pixels.
Este artigo mostra o que a documentação afirma, o que os rastreadores de preços de terceiros informam e onde as duas fontes divergem, para que você possa estimar um custo mensal real antes de escrever qualquer linha de código de integração. Tudo marcado como documentado vem da documentação oficial. Tudo marcado como informado vem de fontes externas e merece ser conferido no seu próprio painel.
Vários textos sobre preços de 2026 datam a mudança em 28 de abril de 2026, quando a Magnific passou a ser a marca única para os recursos de banco de imagens e para um conjunto de IA que abrange imagem, vídeo, áudio, 3D e design. Para quem usa a API, os efeitos visíveis são pequenos, mas reais.
docs.freepik.com responde com um redirecionamento permanente para docs.magnific.com (documentado).api.freepik.com quanto api.magnific.com ainda eram aceitos durante a migração (informado).💡 Dica: Coloque o host e os nomes dos cabeçalhos em um único arquivo de configuração. Assim, a próxima renomeação vira uma mudança de uma linha, em vez de uma busca por todo o seu código.
Três endpoints fazem quase todo o trabalho em projetos de imagem. Todos são assíncronos: você envia um job, recebe um task_id e um status, e depois consulta o resultado ou deixa um webhook_url chamar você de volta. As tarefas do Mystic passam de CREATED para IN_PROGRESS e terminam em um estado final ou em FAILED (documentado).
| Job | Método e caminho | Observações |
|---|---|---|
| Gerar com Mystic | POST /v1/ai/mystic | Texto para imagem, com referências opcionais de estilo e estrutura |
| Upscale criativo | POST /v1/ai/image-upscaler | Pode criar detalhes novos, guiado por um prompt |
| Upscale de precisão | POST /v1/ai/image-upscaler-precision | Mantém o conteúdo original, sem detalhes inventados |
Uma integração típica segue os mesmos quatro passos para os três:
webhook_url.task_id retornado junto ao seu registro, como um pedido ou um ID de produto.
A primeira coisa a definir é qual saldo paga suas chamadas. Confundir os dois é um erro comum de orçamento com esta API.
A documentação afirma que toda requisição de IA, seja de imagem, vídeo, áudio, upscaling ou edição, debita créditos do saldo da sua organização (documentado). Os planos para consumidores são um produto diferente. Os rastreadores listam o Premium a €12 por mês no faturamento anual, com 240.000 créditos por ano, e o Premium+ a €27 por mês, com 600.000 créditos (informado). Vários textos descrevem a API como um serviço separado para desenvolvedores, pré-pago, então confirme de qual saldo suas requisições são debitadas antes de publicar. Um jeito barato de fazer isso: rode uma geração Mystic em 1K e compare o saldo antes e depois. Esse único teste dá o seu preço por imagem, medido na sua própria conta.
A documentação oficial publica uma tabela de preços do upscaler, mas nenhuma tabela de geração por modelo. Os números abaixo vêm de rastreadores de preços de terceiros, então trate-os como uma estimativa inicial.
| Modelo | Preço informado por imagem |
|---|---|
| Classic Fast | $0,005 |
| Flux Dev | $0,012 |
| Flux 2 Pro (1K) | $0,04 |
| Flux Kontext Pro | $0,04 |
| Flux Pro 1.1 | $0,043 |
| HyperFlux | $0,161 |
⚠️ Atenção aos valores fora da curva: um texto atualizado no fim de setembro de 2026 ainda lista a geração Mystic a 0,40 por 100 criações, cerca de 0,004 cada. Isso fica aproximadamente dez vezes abaixo do preço do Flux 2 Pro acima. Uma diferença desse tamanho é um bom motivo para ler a lista de preços atual antes de orçar.
Os textos informam cerca de 5 em crédito inicial gratuito (em euros em um deles, em dólares em outro) e um teto de 500 por mês no autoatendimento antes de você precisar falar com o time comercial (informado). Se o seu plano precisar de mais do que isso, peça um acordo personalizado logo no início, porque as mesmas páginas dizem que limites maiores passam pela equipe de vendas.
O Mystic é o motor de texto para imagem próprio do Freepik, e sua lista de parâmetros é longa o bastante para merecer uma tabela própria.
| Parâmetro | Valores | Padrão |
|---|---|---|
resolution | 1k, 2k, 4k | 2k |
aspect_ratio | 13 predefinições, como widescreen_16_9, social_story_9_16, classic_4_3 | square_1_1 |
model | zen, flexible, fluid, realism, super_real, editorial_portraits | realism |
engine | automatic, magnific_illusio, magnific_sharpy, magnific_sparkle | automatic |
creative_detailing | 0 a 100 | 33 |
fixed_generation | true ou false | false |
structure_reference, style_reference | Imagem em Base64 | nenhum |
filter_nsfw | true ou false | true |
Dois detalhes economizam tempo de depuração. Primeiro, os prompts aceitam referências de personagem escritas como @character_name ou @character_name::strength. Segundo, filter_nsfw não pode ser desativado para usuários padrão, então conteúdo adulto simplesmente não passa por esta API. Pelo nome, super_real e editorial_portraits apontam para trabalhos fotográficos, enquanto zen e fluid soam mais próximos de resultados pictóricos. Rode um pequeno lote de teste de cada um antes de se decidir, usando o mesmo prompt em todos, para que a única variável seja o modelo.
Além do Mystic, a documentação lista Flux Kontext Pro, Flux 2 Pro, Flux 2 Turbo, Flux 2 Klein, Flux Pro 1.1, Flux Dev, Hyperflux, Seedream 4, Seedream 4.5, Z-Image Turbo e um endpoint de texto para imagem da Runway (documentado). Essa amplitude é o verdadeiro diferencial: uma integração e um saldo, muitos geradores.
Os nomes sugerem os usos pretendidos. O Kontext Pro pertence à linha Flux Kontext, construída em torno da edição de uma imagem existente a partir de uma instrução em texto. As variantes Turbo e Klein sugerem velocidade e menor custo por imagem. Seedream 4.5 e Flux 2 Pro são escolhas comuns para visuais de marketing refinados. Como o catálogo muda rápido, leia a lista de modelos atual antes de fixar um nome de modelo no código e mantenha esse nome na configuração, não no seu código-fonte.
É no upscaling que a conta cresce. Os dois modos aceitam fatores de 2x, 4x, 8x e 16x, e ambos são cobrados pela área em pixels da saída, não pelo número de chamadas (documentado).
O endpoint criativo aceita scale_factor, optimized_for, prompt, creativity, hdr, resemblance, fractality, engine e webhook_url. Na prática, ele se comporta como um gerador guiado pela sua foto: acrescenta textura e profundidade que nunca estiveram na origem. Isso combina com ilustração, concept art e fotos suaves que precisam de um impulso. É uma escolha ruim para rostos que você precisa manter fiéis ou para qualquer imagem com texto, porque detalhes inventados podem alterar os dois.
A documentação recomenda enviar a imagem original por URL sempre que possível. Uploads em Base64 e exportações de canvas perdem qualidade antes mesmo de o upscaler vê-los.
O modo de precisão, lançado em meados de 2025 segundo as análises, amplia a imagem sem alucinar conteúdo novo. É a escolha mais segura para logotipos, capturas de interface, fotos de produto e digitalizações. A documentação recomenda uma entrada de pelo menos 256 a 512 pixels no menor lado, PNG para gráficos, JPEG ou PNG de alta qualidade para fotos, e fatores moderados de 2x a 4x, já que ir além tende a amplificar o ruído.
Um jeito rápido de escolher entre os dois modos:
| Sua imagem de origem | Modo mais indicado | Motivo |
|---|---|---|
| Logotipo, ícone ou captura de interface | Precisão | Bordas e letras não podem mudar |
| Foto de produto para catálogo | Precisão | O cliente espera o item real |
| Digitalização antiga ou foto muito comprimida | Criativo, força baixa | A textura que falta precisa vir de algum lugar |
| Ilustração ou concept art | Criativo | Detalhe extra é bem-vindo |
| Retrato de uma pessoa real | Precisão, ou criativo com força baixa | Detalhes inventados podem se afastar do rosto |
A documentação traz três exemplos trabalhados, idênticos para os dois modos. As colunas de megapixels são uma adição minha, para mostrar o padrão.
| Entrada | Saída | Fator | Custo | Tamanho da saída | Custo por megapixel |
|---|---|---|---|---|---|
| 640×480 | 1280×960 | 2x | €0,10 | 1,23 MP | cerca de €0,081 |
| 1920×1080 | 3840×2160 | 2x | €0,20 | 8,29 MP | cerca de €0,024 |
| 640×480 | 5120×3840 | 8x | €0,50 | 19,66 MP | cerca de €0,025 |
A partir de apenas três pontos, duas coisas parecem prováveis (minha inferência, não uma fórmula publicada). Saídas pequenas parecem ficar sobre um piso perto de dez centavos, e saídas grandes se estabilizam em cerca de dois centavos e meio por megapixel. A lição prática: uma imagem minúscula ampliada em 8x custa mais do que um quadro Full HD ampliado em 2x, então defina o tamanho final em pixels antes de escolher o fator.
Os limites documentados são generosos para a maioria dos projetos (documentado):
Os números por IP importam se uma frota de workers compartilha um mesmo endereço de saída. Dez workers que disparam cinco requisições por segundo cada ultrapassam muito a média de 10 por segundo em 2 minutos. Acrescente uma pequena fila e um backoff exponencial quando uma requisição for limitada, e o limite deixa de ser visível para seus usuários.
O limite que realmente pesa não é uma taxa. Os links de saída expiram 30 minutos após a geração, então copie cada resultado para o seu próprio armazenamento no momento em que uma tarefa informar que terminou. Prefira webhooks a loops de consulta apertados e registre cada tarefa FAILED para poder refazê-la antes que a janela se feche.
Suponha que uma loja online queira 1.000 visuais de produto, cada um gerado uma vez e ampliado para 4K. Usando o preço informado do Flux 2 Pro e o preço documentado do upscaler:
| Etapa | Preço unitário | Quantidade | Total |
|---|---|---|---|
| Gerar com Flux 2 Pro em 1K | $0,04 | 1.000 | cerca de $40 |
| Ampliar 1920×1080 para 3840×2160 | €0,20 | 1.000 | €200 |
| Ampliar apenas as 200 melhores | €0,20 | 200 | €40 |
O upscaling custa cerca de cinco vezes mais do que a geração, então a economia mais barata é a curadoria: escolha os vencedores primeiro e amplie somente esses. Miniaturas pequenas funcionam do mesmo jeito. Ampliar 5.000 imagens de 640×480 para 1280×960 a €0,10 cada dá €500, o que equivale ao teto mensal de autoatendimento informado antes.
💡 Dica: Gere na resolução de que você precisa e dispense o upscaler quando a saída em 2k já couber no layout. Cada upscale evitado é um preço unitário inteiro economizado.
Cinco hábitos mantêm a conta estável conforme o volume cresce:
Se você quer comparar a qualidade antes de se comprometer com qualquer API, o Picasso IA hospeda alternativas próximas para as duas metades do fluxo de trabalho, e você pode testá-las no navegador antes.
| Modo Magnific mais próximo | Modelos do Picasso IA | O que esperar |
|---|---|---|
| Criativo | Recraft Creative Upscale, Clarity Pro Upscaler | Mais profundidade e textura, até 16x com o Clarity Pro |
| Precisão | Recraft Crisp Upscale, Topaz Image Upscale | Ampliação fiel, até 6x com o Topaz |
| Trabalhos rápidos em 4x | Real ESRGAN, Google Upscaler, Bria Increase Resolution | Ampliação rápida e previsível |
| Retratos e velocidade | Crystal Upscaler, P Image Upscale | Detalhe de pele, resultados em cerca de um segundo |
A correspondência é de espírito, não de identidade. Cada modelo tem um visual próprio, então rode a mesma foto de teste em dois ou três antes de julgar.
Clarity Pro Upscaler é a correspondência mais próxima do modo criativo da Magnific por causa do seu controle único de criatividade. Ele mantém a estrutura facial, os poros da pele e os fios de cabelo intactos enquanto amplia.
scale_factor. O padrão é 2. Escolha 2, 4, 8 ou 16 conforme o tamanho desejado.creativity. O padrão é 0. Valores negativos ficam próximos do original, valores positivos acrescentam textura e profundidade.output_format. PNG é sem perdas e é o padrão. JPG usa qualidade de 95% e gera arquivos menores.💡 Dica: Comece em 2x com criatividade em 0 e depois ajuste uma configuração de cada vez. Mudar a escala e a criatividade juntas dificulta descobrir qual delas causou a mudança.
Desenvolvedores também podem chamar o Picasso IA por programação. Sua API fica em https://api.picassoia.com/v1 e segue o mesmo padrão do fluxo do Freepik acima: criar uma previsão, consultá-la e buscar o resultado. Quando este artigo foi escrito, ela oferecia quatro modelos (imagem, edição de imagem, vídeo e vídeo com áudio), com 5 previsões simultâneas por conta. A redação do site sobre custo e requisitos de plano não era consistente naquele momento, então confirme na página de preços antes de construir algo sobre ela.
Para um teste rápido, sem nenhuma integração, pegue uma foto suave e de baixa resolução, passe-a pelo Clarity Pro Upscaler em 2x e depois teste o Topaz Image Upscale no mesmo arquivo. Gere uma imagem nova com o Flux 2 Pro e envie-a pelos mesmos passos. Em uma tarde você vai saber qual visual combina com o seu projeto, e terá números reais para comparar com a lista de preços da Magnific. Escolha uma foto, abra um modelo e faça seu primeiro teste hoje.
Escolha seu idioma
