Skip to Content
ModelosMAI Image

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

IDs de modelo (copie exatamente como estão)
MAI Image 2.5 Promicrosoft/mai-image-2.5-proComposições complexas, consistência de pessoas e objetos
MAI Image 2.5microsoft/mai-image-2.5Alterações localizadas precisas
MAI Image 2.5 Flashmicrosoft/mai-image-2.5-flashBaixa latência, geração em lote

Os 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

mai_image.py
import base64 from openai import OpenAI client = OpenAI(api_key="YOUR_OFOX_API_KEY", base_url="https://api.ofox.ai/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)

Resumosize 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.
size solicitadoSaída real
Omitido1024×1024
1024x1024, 2048x2048, 4096x40961024×1024
1536x10241248×832
1024x1536832×1248
100x100768×768
  • 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

Terminal
curl https://api.ofox.ai/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.png

As 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

ErroCausaSolução
Timeout da requisiçãoO timeout do cliente é curto demaisDefina o timeout em 300 segundos ou mais
404 model_not_foundID do modelo digitado incorretamenteCopie o ID do modelo desta página

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.

Última atualização em