Família MAI Image
Os modelos de geração e edição de imagens da Microsoft, três no total. São chamados pelo endpoint compatível com OpenAI, de forma praticamente igual ao GPT Image: texto para imagem usa /v1/images/generations e edição usa /v1/images/edits.
Escolha de modelo
microsoft/mai-image-2.5-proComposições complexas, consistência de pessoas e objetosmicrosoft/mai-image-2.5Alterações localizadas precisasmicrosoft/mai-image-2.5-flashBaixa latência, geração em loteOs três têm os mesmos parâmetros; em nossas medições, gerar uma imagem de 1024×1024 leva cerca de 12 a 25 segundos. Preços atuais na página do modelo .
Texto para imagem
Python
import base64
from openai import OpenAI
client = OpenAI(api_key="YOUR_OFOX_API_KEY", base_url="https://api.ofox.io/v1", timeout=600)
resp = client.images.generate(
model="microsoft/mai-image-2.5-flash",
prompt="Uma maçã vermelha sobre uma mesa branca",
size="1024x1024",
)
with open("output.png", "wb") as f:
f.write(base64.b64decode(resp.data[0].b64_json))Tamanho (size)
size define só a proporção; a saída tem cerca de 1 milhão de pixels, e enviar um tamanho maior não aumenta a resolução.- A saída mantém a proporção solicitada, com o total de pixels ajustado para cerca de 1 milhão; com um tamanho pequeno demais, a saída é 768×768.
- Para resoluções maiores, use o Nano Banana Pro (até 4K) ou o GPT Image.
Edição
curl https://api.ofox.io/v1/images/edits \
--max-time 600 \
-H "Authorization: Bearer $OFOX_API_KEY" \
-F model=microsoft/mai-image-2.5 \
-F prompt="Deixe a maçã roxa e mantenha todo o resto igual" \
-F image=@apple.jpg \
| jq -r '.data[0].b64_json' | base64 --decode > apple_purple.pngAs imagens de referência contam como tokens de entrada; consulte usage.input_tokens_details.image_tokens na resposta. Em nossas medições, uma imagem de referência de 768×768 conta 576 tokens.
Erros comuns
Para várias imagens, faça várias requisições em paralelo, cada uma gerando uma imagem.
Perguntas frequentes
O MAI Image gera imagens em 2K ou 4K?
Não. size define só a proporção, e a saída tem cerca de 1 milhão de pixels no total. Em nossas medições, tanto 2048x2048 quanto 4096x4096 geraram 1024x1024. Para resoluções maiores, use o Nano Banana Pro ou o GPT Image.
Como editar imagens com o MAI Image?
Use /v1/images/edits e envie o arquivo image em um formulário multipart, da mesma forma que no GPT Image.