跳转到主要内容
POST
  1. 提交后会返回 task_id。如果提供了 callback_url,当任务状态变为 finished 或 failed 时,系统会向 callback_url 发送 POST 请求。
  2. 无论是否提供 callback_url,都可以通过统一的查询任务状态接口获取结果。
MAI Image 2.7 文生图每次根据文字提示词生成一张图片。MAI Image 2.7 是微软的图像生成模型,MAI Image 2.7 Flash 是它更快、成本更低的版本。适合产品图、带清晰文字的海报,以及需要透明背景的素材。 如需编辑或组合参考图,请使用 MAI Image 2.7 图像编辑。MAI Image 2.7 与 MAI Image 2.7 Flash 参数相同,参见 MAI Image 2.7 Flash 文生图。

模型

  • microsoft/mai-image-2.7/text-to-image — MAI Image 2.7 文生图,每次一张图片。

功能

  • 7 种宽高比预设,1K(约 100 万像素)或 2K(约 400 万像素)。
  • 自定义 WIDTHxHEIGHT 尺寸,最多 4,194,304 像素。
  • 透明背景;PNG、JPEG 或 WebP 输出。
  • 提示词最多 32,000 个字符。

必填参数

  • prompt (string):图片描述。1–32,000 个字符的文本。图中需要出现的文字请放在引号里。

可选参数

  • size (string):宽高比预设或自定义 WIDTHxHEIGHT。默认 1:1。参见尺寸。
  • resolution (string):1K 或 2K。默认 1K。只对宽高比预设生效。
  • background (string):opaque 或 transparent。默认 opaque。transparent 要求 output_format 为 png 或 webp。
  • output_format (string):png、jpeg 或 webp。默认 png。

尺寸

  • 预设:1:1、4:3、3:4、3:2、2:3、16:9、9:16,按所选 resolution 出图:1K 约 100 万像素(1:1 为 1024x1024),2K 约 400 万像素(16:9 为 2720x1536)。
  • 自定义 WIDTHxHEIGHT(用 x 或 X,例如 3072x1344):两边都必须是 16 的倍数,每边至少 768 像素,总像素最多 4,194,304。图片按给定尺寸原样输出,其他自定义值返回 400。resolution 用于比例预设。

示例

  • 1K 方图:带引号标签文字的产品静物,使用默认参数。
  • 2K 16:9:约 400 万像素(2720x1536)的风景图。
  • 透明抠图:自定义 3072x1344,background: transparent,WebP。

注意事项

  • 每次请求返回一张图片。input 接收上文列出的字段,其他字段返回 400。model 和 callback_url 放在请求根级,与 input 并列。
  • background: transparent 搭配 output_format: jpeg 会返回 400。
  • 使用参考图编辑请用 MAI Image 2.7 图像编辑。
  • 按 token 计费:提示词文本 token 和输出图片 token(输出宽 × 高 / 1024)。价格随输出尺寸变化,2K 和更大的自定义尺寸费用更高。提交时按本次请求的上限预扣,任务完成后按实际输出尺寸结算,最多为预扣金额,多余部分退还。任务失败会全额退还。当前费率见定价页。

授权

Authorization
string
header
必填

使用 Authorization: Bearer VIDGO_API_KEY。

请求体

application/json
model
string
必填
示例:

"microsoft/mai-image-2.7/text-to-image"

input
object
必填
callback_url
string<uri>

可选的 Webhook URL,用于接收完成或失败通知。

示例:

"https://your-domain.com/callback"

响应

任务提交结果。任务 ID 标识一项异步任务;生成可能仍在进行中。

code
integer
必填
示例:

200

data
object
必填