Microsoft MAI Image 2.5 Text to Image API

Microsoft MAI Image 2.5 Text-to-Image

Microsoft MAI Image 2.5 Text-to-Image generates images from natural-language prompts with a simple workflow for prompt input, size selection, and output format control. It is suitable for concept art, marketing visuals, social media content, product mockups, and other prompt-driven image generation workflows.

Why Choose This?

Prompt-based image generation Turn natural-language descriptions into polished visual outputs.
Simple parameter set Use a lightweight workflow with prompt, size, and output format controls.
Flexible output sizing Choose the output size preset that best matches your intended composition.
Multiple output formats Export generated images in supported formats such as png.
Production-ready API Suitable for creative ideation, campaign visuals, concept generation, and content production workflows.

Parameters

Parameter	Required	Description
prompt	Yes	Text description of the image you want to generate.
size	No	Output image size preset, such as `1:1`.
output_format	No	Output image format, such as `png`.

How to Use

Write your prompt — describe the subject, style, lighting, composition, and mood you want.
Choose the size (optional) — select the output framing that fits your use case.
Choose the output format (optional) — select the file format that best fits your workflow.
Submit — run the model and download the generated image.

Example Prompt

A cinematic movie still of an adult US woman standing alone on a rainy city street at night, wet pavement reflecting neon lights, long black coat, calm but emotional expression, soft bokeh background, realistic rain, shallow depth of field, dramatic cinematic lighting, photorealistic, no text

Pricing

Pricing includes a fixed base image charge plus a small surcharge based on prompt length.

Billing Rules

Base price is $0.05 per image
Prompt-length surcharge is $0.0001 for every started 10 characters
size and output_format do not affect pricing

Best Use Cases

Concept art — Explore visual ideas and art directions quickly.
Marketing creatives — Generate ad concepts, banners, and campaign visuals.
Social media content — Create prompt-driven imagery for posts and promotions.
Product mockups — Produce visual concepts for products, packaging, or branded scenes.
Creative prototyping — Iterate rapidly on different visual directions.

Pro Tips

Be specific in your prompt about subject, environment, lighting, and style.
Shorter prompts are cheaper, while longer prompts can provide more control.
Use clear style cues such as cinematic, editorial, photorealistic, minimal, or painterly when needed.
Start with a compact prompt and only add more detail if the result needs stronger direction.
Choose png when you want better image quality for downstream editing.

Notes

prompt is required.
Pricing includes a fixed base image charge and a prompt-length surcharge.
Better prompts usually improve output quality and consistency.

Related Models

Other MAI image generation workflows — Useful when you need different quality, speed, or control trade-offs.
Prompt-based image generation models — Useful when you want alternative visual styles or model behavior.

Mai Image 2.5 Text To Image API — Quick start

Grab a WaveSpeedAI API key, then call POST https://api.wavespeed.ai/api/v3/microsoft/mai-image-2.5/text-to-image with your input as JSON. The endpoint returns a prediction id; poll the prediction endpoint until status flips to completed, then read the output URL from data.outputs[0]. Examples for Mai Image 2.5 Text To Image below.

HTTP example

# Submit the prediction
curl -X POST "https://api.wavespeed.ai/api/v3/microsoft/mai-image-2.5/text-to-image" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $WAVESPEED_API_KEY" \
  -d '{
    "prompt": "A cinematic shot of a city at sunset, soft golden light",
    "size": "1:1",
    "output_format": "png"
}'

# Response includes a prediction id. Poll for the result:
curl -X GET "https://api.wavespeed.ai/api/v3/predictions/{request_id}/result" \
  -H "Authorization: Bearer $WAVESPEED_API_KEY"

# When status is "completed", read the output from data.outputs[0].

Node.js example

// npm install wavespeed
const WaveSpeed = require('wavespeed');

const client = new WaveSpeed(); // reads WAVESPEED_API_KEY from env

const result = await client.run("microsoft/mai-image-2.5/text-to-image", {
        "prompt": "A cinematic shot of a city at sunset, soft golden light",
        "size": "1:1",
        "output_format": "png"
});

console.log(result.outputs[0]); // → URL of the generated output

Python example

# pip install wavespeed
import wavespeed

output = wavespeed.run(
    "microsoft/mai-image-2.5/text-to-image",
    {
    "prompt": "A cinematic shot of a city at sunset, soft golden light",
    "size": "1:1",
    "output_format": "png"
}
)

print(output["outputs"][0])  # → URL of the generated output

Mai Image 2.5 Text To Image API — Frequently asked questions

What is the Mai Image 2.5 Text To Image API?

Mai Image 2.5 Text To Image is a Microsoft model for image generation, exposed as a REST API on WaveSpeedAI. Microsoft MAI Image 2.5 Text-to-Image is a fast AI image generation model that creates photorealistic, design-ready images from text prompts with strong realism, typography, and stylized visual control. Ready-to-use REST inference API for creative design, marketing visuals, product mockups, brand assets, social media content, concept art, and professional text-to-image workflows with simple integration, no coldstarts, and affordable pricing. You can call it programmatically or try it from the playground above.

How do I call the Mai Image 2.5 Text To Image API?

POST your input parameters to the model's REST endpoint (shown in the API tab of this playground) with your WaveSpeedAI API key in the Authorization header. Submission returns a prediction ID; poll the prediction endpoint until status flips to "completed", then read the output URL from the result. The playground generates a ready-to-paste code sample in Python, JavaScript, or cURL for whatever inputs you've set. Full request/response shape is documented at https://wavespeed.ai/docs/docs-api/microsoft/microsoft-mai-image-2.5-text-to-image.

How much does Mai Image 2.5 Text To Image cost per run?

Mai Image 2.5 Text To Image starts at $0.050 per run. That figure is the base price — the final charge scales with the parameters you set in the form (output size, length, count, references, or whatever knobs this model exposes), so a higher-quality or larger output costs more than a minimal one. The exact cost for your current input is shown live next to the Generate button before you submit, and the actual per-call charge is recorded on the prediction afterwards.

What inputs does Mai Image 2.5 Text To Image accept?

Key inputs: `prompt`, `size`, `output_format`. The full JSON schema (types, defaults, allowed values) is rendered above the Generate button and mirrored in the API reference at https://wavespeed.ai/docs/docs-api/microsoft/microsoft-mai-image-2.5-text-to-image.

How do I get started with the Mai Image 2.5 Text To Image API?

Sign up for a free WaveSpeedAI account to claim starter credits, copy your API key from /accesskey, then call the endpoint shown in the API tab of the playground. The playground also auto-generates a code sample in Python, JavaScript, or cURL for the parameters you've set.

Can I use Mai Image 2.5 Text To Image outputs commercially?

Commercial usage rights depend on the model's license, set by its provider (Microsoft). The license summary appears on the model card above; see WaveSpeedAI's Terms of Service for platform-level conditions.

示例查看全部

相關模型

README