guides

MAI Image 2.7 API: o que é o MAI Image 2.7, preços, limites e Flash

Poyo.ai Team
9 min read
Share:

MAI Image 2.7 API na PoYo

A MAI Image 2.7 API dá acesso ao modelo de imagem mais recente da Microsoft AI através de um único endpoint REST na PoYo: mai-image-2.7 para os recursos finais e mai-image-2.7-flash para trabalhos mais baratos e rápidos. Ambos aceitam o mesmo corpo de pedido, geram a partir de um prompt ou editam até 5 imagens de referência e podem devolver ficheiros PNG ou WebP transparentes. Esta página explica o que é o MAI Image 2.7, os limites exatos, os preços por token e o que medimos no dia do lançamento.

O que é o MAI Image 2.7?

O MAI Image 2.7 é o modelo de geração e edição de imagens da Microsoft AI (MAI), lançado juntamente com o MAI Image 2.7 Flash a 17 de novembro de 2026. Segundo a model card da Microsoft, é um modelo baseado em difusão com 20 mil milhões de parâmetros sem contar os embeddings, concebido tanto para text-to-image como para «edição image-to-image precisa e controlável», e o MAI Image 2.7 Flash é «uma versão otimizada do MAI Image 2.7».

A Microsoft afirma que o modelo foi «reconstruído de raiz para fluxos de edição multimodais» e enumera entre as ações de edição a remoção de objetos, a substituição, a alteração de atributos, o inpainting, a atualização de texto e a limpeza de artefactos (como o arrastamento de movimento). A Microsoft diz também que o MAI Image 2.7 estava em 1.º lugar no leaderboard AA-Image-Editing v2.1 da Artificial Analysis a 16 de novembro de 2026, com 1,215 Elo em 5,478 votos.

Numa integração por API, isto traduz-se em três tipos de pedidos que vale a pena enviar aqui:

  • Edições que têm de deixar o resto da imagem intacto: uma mudança de cor de um produto, um objeto substituído, uma placa ou um rótulo reescritos.
  • Imagens com texto incorporado: a model card da Microsoft refere uma «melhor renderização de texto nas imagens geradas, incluindo rótulos, cartazes, embalagens e sinalética».
  • Recursos que precisam de um canal alfa real: a Microsoft diz que ambos os modelos «suportam fundos transparentes», e a PoYo disponibiliza isso como background: "transparent".

A MAI Image 2.7 API em resumo

MAI Image 2.7MAI Image 2.7 Flash
ID de modelo na PoYomai-image-2.7mai-image-2.7-flash
Endpoint de submissãoPOST https://api.poyo.ai/api/generate/submitIgual
ResultadoConsultar GET /api/generate/status/{task_id} ou usar callback_urlIgual
Modos de entradaText-to-image; editar 1 imagem; combinar 2 a 5 imagensIgual
Campos do pedidoprompt, image_urls, size, resolution, background, output_formatIgual
Lançamento da Microsoft17 de novembro de 202617 de novembro de 2026
DocumentaçãoReferência da MAI Image 2.7 APIReferência do MAI Image 2.7 Flash (mesmo esquema)

Os dois esquemas da PoYo diferem apenas no ID de modelo, por isso mudar de nível é alterar uma única string. A comparação dos níveis explica quando compensa cada um.

Limites e campos do pedido

CampoRegra na PoYo
promptObrigatório, de 1 a 32,000 caracteres, tem de conter algo além de espaços. Coloque entre aspas o texto exato que deve aparecer na imagem.
image_urlsArray opcional de 1 a 5 URLs HTTP(S) públicos, JPEG, PNG ou WebP. Uma imagem é editada; várias são combinadas. As imagens de referência são usadas até cerca de 1 megapíxel.
size1:1 (predefinido), 4:3, 3:4, 3:2, 2:3, 16:9, 9:16, ou um WIDTHxHEIGHT personalizado
Tamanho personalizadoAmbos os lados divisíveis por 16, cada lado com pelo menos 768, no máximo 4,194,304 píxeis no total; usado exatamente como indicado
resolution1K (predefinido, cerca de 1 megapíxel, 1:1 é 1024x1024) ou 2K (cerca de 4 megapíxeis, 16:9 é 2720x1536)
backgroundopaque (predefinido) ou transparent; transparent exige png ou webp
output_formatpng (predefinido), jpeg, webp
Imagens por pedido1

Com image_urls e sem size, a saída segue a proporção da primeira imagem de referência a cerca de 1 megapíxel. O limite de 4,194,304 píxeis corresponde à model card da Microsoft, que indica o mesmo «número total máximo de píxeis» e refere que qualquer um dos lados pode ultrapassar 2048 desde que o total se mantenha dentro do limite.

Preços da MAI Image 2.7 API

A PoYo cobra ambos os modelos por tokens, às tarifas da nossa tabela de preços. 1 crédito = $0.005.

Por 1M de tokensMAI Image 2.7 na PoYoMAI Image 2.7 Flash na PoYo
Entrada de texto1,000 créditos ($5.00)350 créditos ($1.75)
Entrada de imagem1,600 créditos ($8.00)500 créditos ($2.50)
Saída de imagem6,800 créditos ($34.00)2,000 créditos ($10.00)

Na PoYo, os tokens de saída acompanham o número de píxeis: cerca de um token por cada 1,024 píxeis. Uma imagem de 1024x1024 corresponde a cerca de 1,024 tokens de saída, ou seja, cerca de 6.96 créditos ($0.035) no MAI Image 2.7 e 2.05 créditos ($0.0102) no Flash, mais um pequeno valor pelos tokens de texto do prompt. A análise de preços percorre todos os tamanhos.

O que medimos no dia do lançamento

A equipa da PoYo executou estes pedidos na API de produção da PoYo a 19 de novembro de 2026. Os tempos vão da submissão ao resultado, vistos por um cliente que consulta o estado a cada poucos segundos, pelo que devem ser considerados aproximados.

PedidoSaídaCusto às tarifas atuaisTempo
mai-image-2.7, 16:9, 2K, png, café numa noite chuvosa com um letreiro de néon a dizer "OPEN LATE"2720x153627.802 créditos (cerca de $0.139)Cerca de 66 s
mai-image-2.7-flash, mesmo pedido2720x15368.1803 créditos (cerca de $0.041)Cerca de 42 s
mai-image-2.7-flash, 1:1, 1K, background: transparent, png1024x1024 RGBA, fundo totalmente transparente2.062 créditos (cerca de $0.0103)Cerca de 42 s

Em ambas as execuções do café, o letreiro dizia "OPEN LATE" exatamente como no prompt. A execução transparente devolveu um canal alfa real, não um fundo branco nem em xadrez; o guia de fundo transparente mostra o pedido completo.

O seu primeiro pedido à MAI Image 2.7 API

curl https://api.poyo.ai/api/generate/submit \
  -H "Authorization: Bearer $POYO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "mai-image-2.7",
    "input": {
      "prompt": "A university campus poster at dusk with the title \"Open Day 2026\", photorealistic, cinematic light",
      "size": "16:9",
      "resolution": "2K"
    }
  }'

A resposta contém data.task_id com o estado not_started. Consulte o endpoint de estado até obter finished e leia a imagem em data.files[0].file_url, ou passe um callback_url no nível superior para receber um POST quando a tarefa terminar. Verifique sempre o campo code no corpo: alguns erros de validação devolvem HTTP 200 com code: 400. O guia da API inclui um ciclo de polling em Python com limite de tempo e um corpo JSON para cada modo de entrada.

Onde o MAI Image 2.7 está disponível

A Microsoft disponibiliza o MAI Image 2.7 como modelo alojado, não como pesos transferíveis. Está em pré-visualização pública no Microsoft Foundry, onde a documentação da Microsoft lista MAI-Image-2.7 e MAI-Image-2.7-Flash (versão 2026-11-02) com implementação Global Standard, e pode experimentá-lo no MAI Labs, que a Microsoft descreve como destinado a uso pessoal e não comercial.

Na PoYo, chama ambos os modelos com a mesma chave de API que usa para qualquer outro modelo, sem subscrição do Azure nem passo de implementação. A estrutura dos pedidos da PoYo também difere da do Foundry: um único endpoint JSON aceita image_urls para edições (o Foundry usa um endpoint de edição multipart separado), e escolhe uma proporção mais 1K/2K ou um tamanho personalizado em vez de largura e altura em bruto.

Que pedidos encaminhar para cada modelo

PedidoModelo a chamar
Imagens hero finais, edições precisas, cartazes e embalagens com muito textomai-image-2.7
Rascunhos, pré-visualizações, miniaturas, catálogos e stickers em grande volumemai-image-2.7-flash
Prompts que precisam de dados atuais da web (atualidade, locais reais)mai-image-2.6 com enable_web_search, veja MAI Image 2.6

O MAI Image 2.7 não aceita a opção de pesquisa web do MAI Image 2.6. Tudo o resto de um pedido 2.6 mantém-se; a comparação 2.7 vs 2.6 lista as alterações de campos e o diff de migração.

Perguntas frequentes

Qual é o ID de modelo da MAI Image 2.7 API? Use mai-image-2.7 para o modelo principal e mai-image-2.7-flash para o Flash. mai-image-2-7 é apenas o slug da página da PoYo e é rejeitado como ID de modelo.

Quanto custa a MAI Image 2.7 API? Na PoYo, o MAI Image 2.7 custa $5.00 / $8.00 / $34.00 por 1M de tokens de entrada de texto, entrada de imagem e saída, e o Flash custa $1.75 / $2.50 / $10.00. Uma imagem de 1024x1024 fica em cerca de $0.035 no MAI Image 2.7 e cerca de $0.0102 no Flash.

A MAI Image 2.7 API consegue gerar imagens novas ou só editar? Ambas. Um pedido apenas com prompt gera uma imagem nova. Acrescentar 1 a 5 URLs em image_urls transforma o mesmo pedido numa edição ou numa composição de várias imagens.

A MAI Image 2.7 API suporta fundos transparentes? Sim. Envie "background": "transparent" com "output_format": "png" ou "webp". O nosso teste com o Flash no dia do lançamento devolveu um PNG RGBA de 1024x1024 com fundo totalmente transparente.

Qual é a maior imagem que a MAI Image 2.7 API consegue devolver? 4,194,304 píxeis, por exemplo 2048x2048 ou um 3072x1344 personalizado. Em 2K, 16:9 devolve 2720x1536.

Quanto tempo demora um pedido à MAI Image 2.7 API? No nosso teste de 19 de novembro de 2026, uma imagem 2K em 16:9 demorou cerca de 66 segundos no MAI Image 2.7 e cerca de 42 segundos no Flash. Use polling com um prazo ou um callback_url em vez de manter um pedido aberto.

Share: