APIMart
MAI Image 2.7 のモデルアイコン
画像

MAI Image 2.7 API

Microsoft MAI Image 2.7 の画像編集モデルに向けて編集内容を整理します。MAI Image API Playground で元画像と指示を組み合わせ、シーン、光、文字、残したい細部を説明できます。

画像編集シーンと照明文字と細部

MAI Image 2.7 API 設定概要

  • ファイルまたは URL の元画像
  • プロンプトによる編集指示
  • Form と JSON の設定
Input

変更する部分と、残したい細部を指定してください。

出力

画像を選び、変更内容を説明してください。

MAI Image 2.7 API で編集方針を準備

元画像と明確な変更目的から始めます。編集用の作業画面で、変更したい内容と保持したい構図、素材、細部を分けて記述できます。

MAI Image 2.7 API の呼び出し例:画像編集

このコード例で元画像と編集指示を含む画像編集リクエストを組み立て、タスクを照会して結果を取得する流れを確認できます。

  1. 1

    MAI Image 2.7 API リクエストを認証する

    APIMart API キーを環境変数 APIMART_API_KEY に保存します。編集の送信時とタスクの照会時に、Authorization: Bearer <key> として送信してください。

  2. 2

    画像編集タスクを送信する

    POST /v1/images/generations に、model を mai-image-2.7、prompt を編集指示として設定し、元画像の HTTP または HTTPS URL を 1 つ含む image_urls を送信します。レスポンスの data[0].task_id からタスク ID を取得します。

  3. 3

    編集後の画像を取得する

    GET /v1/tasks/{task_id} でタスクを照会します。ステータスが completed なら data.result.images[0].url[0] から画像 URL を取得し、failed なら data.error.message で失敗の理由を確認します。

    APIMart の認証方法と 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必須既定値: —編集する元画像の HTTP または HTTPS URL を 1 つだけ含む配列。