
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.7 | MAI Image 2.7 Flash | |
|---|---|---|
| ID de modelo na PoYo | mai-image-2.7 | mai-image-2.7-flash |
| Endpoint de submissão | POST https://api.poyo.ai/api/generate/submit | Igual |
| Resultado | Consultar GET /api/generate/status/{task_id} ou usar callback_url | Igual |
| Modos de entrada | Text-to-image; editar 1 imagem; combinar 2 a 5 imagens | Igual |
| Campos do pedido | 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 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
| Campo | Regra na PoYo |
|---|---|
prompt | Obrigató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_urls | Array 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. |
size | 1:1 (predefinido), 4:3, 3:4, 3:2, 2:3, 16:9, 9:16, ou um WIDTHxHEIGHT personalizado |
| Tamanho personalizado | Ambos 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 |
resolution | 1K (predefinido, cerca de 1 megapíxel, 1:1 é 1024x1024) ou 2K (cerca de 4 megapíxeis, 16:9 é 2720x1536) |
background | opaque (predefinido) ou transparent; transparent exige png ou webp |
output_format | png (predefinido), jpeg, webp |
| Imagens por pedido | 1 |
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 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 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.
| Pedido | Saída | Custo às tarifas atuais | Tempo |
|---|---|---|---|
mai-image-2.7, 16:9, 2K, png, café numa noite chuvosa com um letreiro de néon a dizer "OPEN LATE" | 2720x1536 | 27.802 créditos (cerca de $0.139) | Cerca de 66 s |
mai-image-2.7-flash, mesmo pedido | 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 |
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
| Pedido | Modelo a chamar |
|---|---|
| Imagens hero finais, edições precisas, cartazes e embalagens com muito texto | mai-image-2.7 |
| Rascunhos, pré-visualizações, miniaturas, catálogos e stickers em grande volume | mai-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.