APIMart
MAI Image 2.7 模型图标
图像

MAI Image 2.7 API

围绕 Microsoft MAI Image 2.7 图片编辑模型规划修改方向。在 MAI Image API Playground 中结合原图与明确指令,描述场景、光线、文字,以及需要保留的细节。

图片编辑场景与光照文字与细节

MAI Image 2.7 API 配置概览

  • 本地文件或链接形式的原图
  • 提示词中的图片编辑指令
  • Form 与 JSON 配置
Input

说明需要修改的内容,以及应当保留的细节。

输出

选择图片并描述修改内容。

用 MAI Image 2.7 API 准备有针对性的编辑

从原图和清晰的修改目标出发,在 编辑工作台中分别说明需要改变的内容,以及应保持不变的构图、材质和细节。

MAI Image 2.7 API 调用示例:图片编辑

通过示例代码组织包含原图和编辑指令的图片编辑请求,再查询任务以获取结果。

  1. 1

    配置 MAI Image 2.7 API 请求鉴权

    将 APIMart API Key 保存到环境变量 APIMART_API_KEY。提交编辑和查询任务时,均通过 Authorization: Bearer <key> 发送该 Key。

  2. 2

    提交图片编辑任务

    向 POST /v1/images/generations 发送请求,model 设为 mai-image-2.7,prompt 填写编辑指令,image_urls 放入 1 个 HTTP 或 HTTPS 原图 URL。从响应的 data[0].task_id 读取任务 ID。

  3. 3

    查询编辑后的图片

    通过 GET /v1/tasks/{task_id} 查询任务。状态为 completed 时,从 data.result.images[0].url[0] 读取图片 URL;状态为 failed 时,从 data.error.message 查看失败原因。

    鉴权方式和 API 通用用法请参阅APIMart 文档。

POST /v1/images/generations
curl -X POST https://api.apimart.ai/v1/images/generations \
  -H "Authorization: Bearer $APIMART_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "mai-image-2.7",
    "prompt": "将图中的产品放在柔和晨光下的大理石厨房台面上,保持产品形状和标签不变。",
    "image_urls": [
      "https://example.com/source-image.jpg"
    ]
  }'

MAI Image 2.7 API 参数

参数类型必填默认值说明
modelstring是默认值: mai-image-2.7本页示例使用的模型值:mai-image-2.7。
promptstring是默认值: —描述希望进行的编辑,以及原图中需要保留的元素。
image_urlsarray是默认值: —包含且仅包含 1 个原图 HTTP 或 HTTPS URL 的数组,用于图片编辑。