跳转到主要内容
POST
  1. 提交后会返回 task_id。如果提供了 callback_url,当任务状态变为 finished 或 failed 时,系统会向 callback_url 发送 POST 请求。
  2. 无论是否提供 callback_url,都可以通过统一的查询任务状态接口获取结果。
MAI Image 2.7 Flash 图像编辑根据文字指令修改图片,或把多张参考图组合成一张新图。MAI Image 2.7 Flash 是微软 MAI Image 2.7 更快、成本更低的版本,适合草图和批量生成。 只用提示词生成图片时,请使用 MAI Image 2.7 Flash 文生图。MAI Image 2.7 Flash 与 MAI Image 2.7 参数相同,参见 MAI Image 2.7 文生图。

模型

  • microsoft/mai-image-2.7-flash/edit — MAI Image 2.7 Flash 图像编辑,1–5 张参考图,每次一张图片。

功能

  • 编辑一张图片,或组合最多 5 张参考图(JPEG、PNG 或 WebP)。
  • 省略 size 时,输出沿用第一张参考图的宽高比,约 100 万像素。
  • 宽高比预设(1K 或 2K),或最多 4,194,304 像素的自定义尺寸。
  • 透明背景;PNG、JPEG 或 WebP 输出。

必填参数

  • prompt (string):编辑指令。1–32,000 个字符的文本。
  • image_urls (string[]):1–5 张参考图(JPEG、PNG 或 WebP),使用公开可访问的 HTTP(S) URL。一张图时编辑该图,多张图时组合。

可选参数

  • size (string):宽高比预设或自定义 WIDTHxHEIGHT。省略时输出沿用第一张参考图的宽高比,约 100 万像素。参见尺寸。
  • 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 用于比例预设。

示例

  • 编辑一张图片:更换背景,尺寸沿用参考图。
  • 组合图片:两张参考图合成,4:3、2K。
  • 透明抠图:background: transparent,PNG。

注意事项

  • 每次请求返回一张图片。input 接收上文列出的字段,其他字段返回 400。model 和 callback_url 放在请求根级,与 input 并列。
  • background: transparent 搭配 output_format: jpeg 会返回 400。
  • image_urls 接收 1–5 个有效的 HTTP(S) URL,其他值返回 400。超过约 100 万像素的参考图会在生成前缩小。
  • 按 token 计费:提示词文本 token、参考图 token(按像素数计,每张最多约 100 万像素)和输出图片 token(输出宽 × 高 / 1024)。价格随输出尺寸变化,2K 和更大的自定义尺寸费用更高。提交时按本次请求的上限预扣,任务完成后按实际输出尺寸结算,最多为预扣金额,多余部分退还。任务失败会全额退还。当前费率见定价页。

授权

Authorization
string
header
必填

使用 Authorization: Bearer VIDGO_API_KEY。

请求体

application/json
model
string
必填
示例:

"microsoft/mai-image-2.7-flash/edit"

input
object
必填
callback_url
string<uri>

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

示例:

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

响应

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

code
integer
必填
示例:

200

data
object
必填