
A MAI Image 2.7 API dá acesso ao modelo de imagem mais recente da Microsoft AI por meio de um único endpoint REST na PoYo: mai-image-2.7 para os assets finais e mai-image-2.7-flash para jobs mais baratos e rápidos. Os dois aceitam o mesmo corpo de requisição, geram a partir de um prompt ou editam até 5 imagens de referência e podem retornar arquivos 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 junto com o MAI Image 2.7 Flash em 17 de novembro de 2026. Segundo a model card da Microsoft, é um modelo baseado em difusão com 20 bilhões de parâmetros sem contar os embeddings, criado tanto para text-to-image quanto 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 do zero para fluxos de edição multimodais" e lista 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 artefatos (como o borrão de movimento). A Microsoft também diz que o MAI Image 2.7 estava em 1º lugar no leaderboard AA-Image-Editing v2.1 da Artificial Analysis em 16 de novembro de 2026, com 1,215 Elo em 5,478 votos.
Em uma integração via API, isso se traduz em três tipos de requisição que vale a pena enviar aqui:
- Edições que precisam deixar o resto da imagem intacto: troca de cor de um produto, um objeto substituído, uma placa ou um rótulo reescritos.
- Imagens com texto dentro: a model card da Microsoft cita uma "renderização melhor de texto nas imagens geradas, incluindo rótulos, pôsteres, embalagens e sinalização".
- Assets que precisam de um canal alfa de verdade: a Microsoft diz que os dois modelos "suportam fundos transparentes", e a PoYo expõe isso como
background: "transparent".
A MAI Image 2.7 API em resumo
| MAI Image 2.7 | MAI Image 2.7 Flash | |
|---|---|---|
| ID de modelo na PoYo | mai-image-2.7 | mai-image-2.7-flash |
| Endpoint de envio | POST https://api.poyo.ai/api/generate/submit | Igual |
| Resultado | Fazer polling em GET /api/generate/status/{task_id} ou usar callback_url | Igual |
| Modos de entrada | Text-to-image; editar 1 imagem; combinar de 2 a 5 imagens | Igual |
| Campos da requisição | prompt, image_urls, size, resolution, background, output_format | Igual |
| Lançamento da Microsoft | 17 de novembro de 2026 | 17 de novembro de 2026 |
| Documentação | Referência da MAI Image 2.7 API | Referência do MAI Image 2.7 Flash (mesmo schema) |
Os dois schemas da PoYo diferem só no ID de modelo, então trocar de nível é mudar uma única string. A comparação entre os níveis mostra quando cada um compensa.
Limites e campos da requisição
| Campo | Regra na PoYo |
|---|---|
prompt | Obrigatório, de 1 a 32,000 caracteres, precisa ter algo além de espaços. Coloque entre aspas o texto exato que deve aparecer na imagem. |
image_urls | Array opcional de 1 a 5 URLs HTTP(S) públicas, JPEG, PNG ou WebP. Uma imagem é editada; várias são combinadas. As imagens de referência são usadas até cerca de 1 megapixel. |
size | 1:1 (padrão), 4:3, 3:4, 3:2, 2:3, 16:9, 9:16, ou um WIDTHxHEIGHT personalizado |
| Tamanho personalizado | Os dois lados divisíveis por 16, cada lado com pelo menos 768, no máximo 4,194,304 pixels no total; usado exatamente como informado |
resolution | 1K (padrão, cerca de 1 megapixel, 1:1 é 1024x1024) ou 2K (cerca de 4 megapixels, 16:9 é 2720x1536) |
background | opaque (padrão) ou transparent; transparent exige png ou webp |
output_format | png (padrão), jpeg, webp |
| Imagens por requisição | 1 |
Com image_urls e sem size, a saída segue a proporção da primeira imagem de referência em cerca de 1 megapixel. O teto de 4,194,304 pixels bate com a model card da Microsoft, que traz o mesmo "número total máximo de pixels" e observa que qualquer lado pode passar de 2048 desde que o total fique dentro do limite.
Preço da MAI Image 2.7 API
A PoYo cobra os dois modelos por tokens, nas tarifas da nossa tabela de preços. 1 crédito = $0.005.
| Por 1M de tokens | MAI Image 2.7 na PoYo | MAI Image 2.7 Flash na PoYo |
|---|---|---|
| Entrada de texto | 1,000 créditos ($5.00) | 350 créditos ($1.75) |
| Entrada de imagem | 1,600 créditos ($8.00) | 500 créditos ($2.50) |
| Saída de imagem | 6,800 créditos ($34.00) | 2,000 créditos ($10.00) |
Na PoYo, os tokens de saída acompanham o número de pixels: cerca de um token a cada 1,024 pixels. Uma imagem de 1024x1024 dá 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. O detalhamento de preços percorre todos os tamanhos.
O que medimos no dia do lançamento
A equipe da PoYo executou estas requisições na API de produção da PoYo em 19 de novembro de 2026. Os tempos vão do envio ao resultado, vistos por um cliente que faz polling a cada poucos segundos, então considere-os aproximados.
| Requisição | Saída | Custo nas tarifas atuais | Tempo |
|---|---|---|---|
mai-image-2.7, 16:9, 2K, png, café em uma noite chuvosa com um letreiro de neon escrito "OPEN LATE" | 2720x1536 | 27.802 créditos (cerca de $0.139) | Cerca de 66 s |
mai-image-2.7-flash, mesma requisição | 2720x1536 | 8.1803 créditos (cerca de $0.041) | Cerca de 42 s |
mai-image-2.7-flash, 1:1, 1K, background: transparent, png | 1024x1024 RGBA, fundo totalmente transparente | 2.062 créditos (cerca de $0.0103) | Cerca de 42 s |
Nas duas execuções do café, o letreiro dizia "OPEN LATE" exatamente como no prompt. A execução transparente retornou um canal alfa de verdade, não um fundo branco nem quadriculado; o guia de fundo transparente mostra a requisição completa.
Sua primeira requisição à 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 traz data.task_id com o status not_started. Faça polling no endpoint de status até ele ficar 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. Sempre verifique o campo code no corpo: alguns erros de validação retornam HTTP 200 com code: 400. O guia da API tem um loop 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 oferece o MAI Image 2.7 como modelo hospedado, não como pesos para download. Ele está em preview público 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 implantação Global Standard, e você pode testá-lo no MAI Labs, que a Microsoft descreve como destinado a uso pessoal e não comercial.
Na PoYo, você chama os dois modelos com a mesma chave de API que usa para qualquer outro modelo, sem assinatura do Azure nem etapa de implantação. O formato das requisições da PoYo também é diferente do Foundry: um único endpoint JSON aceita image_urls para edições (o Foundry usa um endpoint de edição multipart separado), e você escolhe uma proporção mais 1K/2K ou um tamanho personalizado em vez de largura e altura brutas.
Quais requisições encaminhar para cada modelo
| Requisição | Modelo a chamar |
|---|---|
| Imagens hero finais, edições precisas, pôsteres e embalagens com muito texto | mai-image-2.7 |
| Rascunhos, prévias, miniaturas, catálogos e stickers em grande volume | mai-image-2.7-flash |
| Prompts que precisam de informações atuais da web (notícias, lugares 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 busca na web que o MAI Image 2.6 tem. Todo o resto de uma requisição 2.6 continua valendo; a comparação 2.7 vs 2.6 lista as mudanças 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 é só 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 sai por cerca de $0.035 no MAI Image 2.7 e cerca de $0.0102 no Flash.
A MAI Image 2.7 API gera imagens novas ou só edita?
As duas coisas. Uma requisição só com prompt gera uma imagem nova. Adicionar de 1 a 5 URLs em image_urls transforma a mesma requisição em uma edição ou em uma composição de várias imagens.
A MAI Image 2.7 API suporta fundo transparente?
Sim. Envie "background": "transparent" com "output_format": "png" ou "webp". Nosso teste com o Flash no dia do lançamento retornou um PNG RGBA de 1024x1024 com fundo totalmente transparente.
Qual é a maior imagem que a MAI Image 2.7 API pode retornar?
4,194,304 pixels, por exemplo 2048x2048 ou um 3072x1344 personalizado. Em 2K, 16:9 retorna 2720x1536.
Quanto tempo leva uma requisição à MAI Image 2.7 API?
No nosso teste de 19 de novembro de 2026, uma imagem 2K em 16:9 levou cerca de 66 segundos no MAI Image 2.7 e cerca de 42 segundos no Flash. Use polling com prazo máximo ou um callback_url em vez de manter uma requisição aberta.