MAI Image 2.7 Flash API

microsoft/mai-image-2.7-flash/text-to-image
1K · 2K · WIDTHxHEIGHT

The MAI Image 2.7 Flash API is Microsoft AI's faster, lower-cost image model for text to image, with the same fields as MAI Image 2.7: 1K or 2K, custom sizes, transparent PNG or WebP and quoted in-image text. Vidgo bills the MAI Image 2.7 Flash API by actual tokens, about 2.0 credits ($0.010) per 1K image.

Get API Key
Input
Required241/32000
Optional
Optional
Optional
Optional
OutputReady

Maximum upfront charge: 2.19735 credits · $0.01099

Billed by actual tokens. A 1K square image costs about 2.0 credits; the difference is returned after completion.

Continue using

Examples

output-895e4a62c6f7.jpg

Overhead food photograph of Peruvian ceviche on a dark slate plate: glossy cubes of white fish in lime juice, thin slices of red onion, chopped cilantro, a wedge of orange sweet potato and toasted corn kernels, a halved lime and a small glass of leche de tigre beside the plate, natural window light from the left.

output-f4c869196003.png

Illustrated hiking map of a small fictional volcanic island in gouache style: a smoking volcano in the center, a dotted trail winding from a fishing harbor up to the crater, a black-sand beach and a lighthouse on a rocky point. Hand-lettered labels read exactly "EMBER PEAK", "SALT COVE", "OLD HARBOR" and "LIGHTHOUSE TRAIL". These are the only words. A small compass rose in the corner, cream paper texture.

What is the MAI Image 2.7 Flash API?

MAI Image 2.7 Flash is the optimized version of Microsoft AI's MAI Image 2.7, released together with it on November 17, 2026 for fast, cost-efficient generation. The MAI Image 2.7 Flash API accepts exactly the same request fields as MAI Image 2.7, so one prompt moves between the two by changing the model ID. Each request returns one image at seven aspect ratios in 1K or 2K, or at a custom size up to 4,194,304 pixels.

Why choose the MAI Image 2.7 Flash API?

The MAI Image 2.7 Flash API is the faster, lower-cost MAI image model, with the same fields as MAI Image 2.7 at about 2.0 credits per 1K image.

  • About a third of the priceFlash costs 2,000 credits per 1M output tokens, about 2.0 credits for a 1K square image.

  • Same fields as MAI Image 2.7prompt, size, resolution, background and output_format match MAI Image 2.7, so drafts on Flash rerun on the full model unchanged.

  • Transparent stickers and iconsSet background to transparent with png or webp; the axolotl sticker example returns a clean alpha channel at 1K.

  • Labels and letteringQuoted words such as "EMBER PEAK" and "SALT COVE" render on maps, posters and packaging.

  • Exact sizesSend a custom WIDTHxHEIGHT for banners, thumbnails and social formats, and the image matches it exactly.

What parameters does the MAI Image 2.7 Flash API accept?

This API needs one field, prompt. Optional size, resolution, background and output_format match MAI Image 2.7.

ParameterRequirementDescription
promptRequired

Non-blank text, up to 32,000 characters. Put on-image text in straight double quotes.

sizeOptional

Default 1:1. Ratios: 1:1, 4:3, 3:4, 3:2, 2:3, 16:9, 9:16, or custom WIDTHxHEIGHT with both sides multiples of 16, each side at least 768 and up to 4,194,304 pixels in total, used exactly.

Default1:1
resolutionOptional

1K or 2K for ratio sizes. 1K is about 1 megapixel (1024×1024 at 1:1); 2K is about 4 megapixels (2720×1536 at 16:9).

Default1K2K
backgroundOptional

opaque or transparent. transparent returns an alpha channel with png or webp.

Defaultopaquetransparent
output_formatOptional

png, jpeg or webp.

Defaultpngjpegwebp

How do you use the MAI Image 2.7 Flash API?

Send a prompt to the API, pick a size and format, then read the image URL when the task is finished.

  1. Write the promptDescribe subject, style and light, and quote any words that should appear.

  2. Choose the sizePick one of seven ratios or an exact WIDTHxHEIGHT.

  3. Set resolution1K for fast drafts and thumbnails, 2K for about 4 megapixels.

  4. Pick background and formattransparent with png or webp for cutouts, jpeg for photos.

  5. Run and collectSubmit the task and read the image URL once it finishes.

How much does the MAI Image 2.7 Flash API cost?

A 1K image on the MAI Image 2.7 Flash API costs about 2.0 credits ($0.010). Billing follows actual tokens: 350 credits per 1M text input and 2,000 per 1M image output; 1 credit = $0.005.

Output tokens equal width × height ÷ 1024, so a 1K square image uses about 2.0 credits ($0.010) and a 2K square image about 8.2 credits ($0.041). At submission the MAI Image 2.7 Flash API holds a cap from the prompt length (UTF-8 bytes ÷ 4), 1,088 output tokens for 1K or unsized edits, 4,096 for 2K and the exact count for custom sizes. On completion you pay the actual tokens and the rest returns to your balance; failed tasks are refunded in full.

How much does the MAI Image 2.7 Flash API cost?
UsageCredits / 1M tokensUSD / 1M tokens
Text input350$1.75
Image output2,000$10.00

What is the MAI Image 2.7 Flash API best for?

This API suits high-volume thumbnails, prompt drafts, transparent stickers and food or product shots.

  • High-volume contentGenerate thumbnails, social images and catalog variations at about 2.0 credits per 1K image.

  • Prompt explorationTest compositions and wording on Flash, then render the chosen prompt on MAI Image 2.7.

  • Stickers and app assetsCreate transparent icons, stickers and illustrations for apps and games.

  • Food and product shotsProduce bright overhead food and product photos for menus, listings and blogs.

Pro Tips

  • Keep one prompt and switch the model ID between microsoft/mai-image-2.7-flash and microsoft/mai-image-2.7 to compare.
  • Use 1K for previews and step up to 2K for the images you publish.
  • Quote labels exactly and say they are the only words, as in the Ember Island map.
  • Ask for one isolated object and set background to transparent for clean stickers.

Notes

  • Each request returns one image; prompt accepts up to 32,000 characters.
  • resolution applies to ratio sizes; custom sizes are used exactly as given.
  • To edit images or combine up to 5 references, use MAI Image 2.7 Flash Edit.
  • Tasks run asynchronously: submission returns a task_id, and a callback_url can receive the finished result.

Sources

Model details on this page come from Microsoft AI's own publications:

“MAI Image 2.7 Flash delivers production-ready visuals with strong photorealism, prompt adherence, and creative flexibility at less than half the cost of our flagship model.”

— Microsoft AI, MAI Image 2.7 | Microsoft AI

“MAI Image 2.7 combines exceptional photorealism, reliable prompt adherence, and advanced editing capabilities for everyday creative and commercial workflows.”

— Microsoft AI, MAI Image 2.7 | Microsoft AI

MAI Image 2.7 Flash API FAQ

What is the MAI Image 2.7 Flash API?

The MAI Image 2.7 Flash API gives developers MAI Image 2.7 Flash, the faster, lower-cost version of the image model Microsoft AI released on November 17, 2026. It generates one image per request from a prompt at 1K, 2K or a custom size, renders quoted text and supports transparent backgrounds, with the same fields as MAI Image 2.7. You can call it programmatically or try it from the playground above.

How much does the MAI Image 2.7 Flash API cost?

On Vidgo the MAI Image 2.7 Flash API costs 350 credits ($1.75) per 1M text input tokens and 2,000 credits ($10) per 1M output tokens. A 1K square image costs about 2.0 credits ($0.010) and a 2K square image about 8.2 credits ($0.041).

How do I call the MAI Image 2.7 Flash API?

Send POST https://api.vidgo.ai/api/generate/submit with "model": "microsoft/mai-image-2.7-flash/text-to-image" and an input object with prompt plus optional size, resolution, background and output_format. Poll GET /api/generate/status/{task_id} or set a callback_url.

What is the difference between MAI Image 2.7 Flash and MAI Image 2.7?

Both accept the same fields and sizes. Flash is Microsoft's optimized version for speed and cost, at about 2.0 credits per 1K image versus 7.0 on MAI Image 2.7. Use the MAI Image 2.7 Flash API for drafts and volume, and MAI Image 2.7 for final images.

Can the MAI Image 2.7 Flash API make transparent PNGs?

Yes. Set background to transparent and output_format to png or webp. The axolotl sticker on this page came from one request at 1K.

What sizes does the MAI Image 2.7 Flash API support?

1:1, 4:3, 3:4, 3:2, 2:3, 16:9 and 9:16 at 1K or 2K, plus a custom WIDTHxHEIGHT with multiples of 16, at least 768 per side and up to 4,194,304 pixels.

Can MAI Image 2.7 Flash render text in images?

Yes. Quote the words in straight double quotes and state that they are the only text. The Ember Island map example renders four hand-lettered place names in one request.