跳转到主要内容
POST
  1. 提交后会返回 task_id。如果提供了 callback_url,当任务状态变为 finished 或 failed 时,系统会向 callback_url 发送 POST 请求。
  2. 无论是否提供 callback_url,都可以通过统一的查询任务状态接口获取结果。
使用 mai-image-2.7-flash 根据提示词快速迭代海报、产品图、Logo 等各类图像,也可以编辑和合成参考图。它与 MAI Image 2.7 参数相同,速度更快、成本更低。

模型

  • mai-image-2.7-flash — 速度更快、成本更低的微软 MAI Image 2.7 Flash,支持文生图、图像编辑和多图合成

功能

  • 根据最多 32,000 个字符的提示词生成图像。
  • 编辑单张参考图,或将最多 5 张参考图合成为一张图像。
  • 提供 7 种宽高比,可选 1K 或 2K,也支持最多 4,194,304 像素的自定义 WIDTHxHEIGHT 尺寸。
  • PNG 和 WebP 输出支持透明背景。
  • 支持 PNG、JPEG 或 WebP 输出。

输入模式

  • 文生图 — 不传 image_urls。输出尺寸由 size 和 resolution 决定。
  • 编辑 / 合成 — 在 image_urls 中传入 1 到 5 个 URL。传一张图时编辑该图,传两张及以上时将它们合成为一张。不传 size 时,输出跟随第一张参考图的宽高比,约 100 万像素;传入 size 时按该尺寸输出。

必填参数

  • prompt (string):描述图像或所需编辑的提示词,1–32,000 个字符,必须包含非空白文本。需要原样出现在图上的文字,请用引号括起来。

可选参数

  • image_urls (array of strings):1 到 5 个可公开访问的 HTTP(S) 参考图 URL,格式为 JPEG、PNG 或 WebP。传入后进入编辑 / 合成模式。
  • size (string):1:1、4:3、3:4、3:2、2:3、16:9、9:16 或自定义 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。1K 输出约 100 万像素(例如 1:1 为 1024×1024)。2K 输出约 400 万像素(例如 16:9 为 2720×1536)。
  • 自定义 WIDTHxHEIGHT 尺寸要求宽和高都能被 16 整除,每边不小于 768,总像素数不超过 4,194,304(例如 2048x2048 或 3072x1344)。自定义尺寸按填写的宽高原样输出,resolution 用于宽高比尺寸。
  • 编辑 / 合成模式下不传 size 时,输出跟随第一张参考图的宽高比,约 100 万像素。

输出

  • 每次请求返回一张图像,格式由 output_format 决定(默认 png)。
  • background 设为 transparent 时,图像带 alpha 通道。请搭配 output_format png 或 webp 使用。

示例

文生图

图像编辑

自定义尺寸

透明背景

注意事项

  • 每次请求返回一张图像。
  • image_urls 必须是数组,即使只有一张图像。
  • 参考图按最大约 100 万像素使用。

授权

Authorization
string
header
必填

所有 API 接口都需要 Bearer Token 认证。

创建 API Key:登录 PoYo,进入 仪表盘 → API 密钥(poyo.ai/zh/dashboard/api-key),点击创建 Key。

在请求头中添加:

请求体

application/json
model
enum<string>
必填

MAI Image 2.7 Flash 模型标识。

可用选项:
mai-image-2.7-flash
input
object
必填

生成一张图像;传入 image_urls 时编辑或合成参考图。

callback_url
string<uri>

可选的 Webhook URL,用于任务完成或失败时的通知。

响应

任务提交成功

code
enum<integer>
必填

业务状态码。200 表示成功,其他值都表示请求失败。请务必检查这个字段:部分参数校验错误会以 HTTP 200 返回,响应体里的 code 为 400。

  • 200:成功
  • 400:请求参数无效
  • 401:API Key 缺失或无效
  • 402:积分不足
  • 403:没有权限
  • 404:资源不存在
  • 408:请求超时
  • 429:请求频率超限
  • 500:服务器内部错误
  • 502:上游服务错误
  • 503:服务暂不可用

详见错误码。

可用选项:
200,
400,
401,
402,
403,
404,
408,
429,
500,
502,
503
示例:

200

data
object
必填