画像を編集

参照画像をアップロードし、プロンプトに従って編集します。

POST/v1/images/edits

参照画像をアップロードし、プロンプトに従って編集します。

認証

bearerAuth

認証Bearer <token>

プラットフォームの API Key を使用します。形式は Authorization: Bearer your-api-key です。

指定位置: header

リクエストボディ

multipart/form-data

TypeScript 型定義

TypeScript で request body 型を使用します。

model*string

プラットフォームのモデル ID。

prompt*string

画像編集の指示。プロンプト拡張は常に有効です。前後の空白を除く Unicode 文字数で数え、空白のみは指定できません。

長さ1 <= length <= 32000

n?integer

生成する画像の枚数。

範囲1 <= value <= 10

デフォルト値1

size?string

auto または WIDTHxHEIGHT。デフォルトは auto。指定面積は 655,360–20,000,000 ピクセル、縦横比は 1:3–3:1。幅と高さを指定する場合は aspect_ratio と area を省略します。

デフォルト値"auto"

aspect_ratio?string

デフォルトは auto。拡張されたプロンプトで決まり、編集時は参照画像も考慮します。X:Y も指定可能で、X、Y は 1–300 の整数、比率は 1:3–3:1。size の省略時または auto の場合のみ使用します。

area?string

面積のプリセット。デフォルトは 4K。size の省略時または auto の場合のみ使用し、実際の寸法は data[].size に返されます。

指定可能な値

"1K"
"2K"
"4K"

output_format?string

画像形式。jpg と jpeg は同等で、レスポンスは jpeg に統一されます。

デフォルト値"jpeg"

指定可能な値

"jpeg"
"jpg"
"png"
"webp"

response_format?string

url リンクの有効期間は 24 時間。b64_json は Base64 を返し、ストリーミングには対応しません。Base64 の総出力面積上限は PNG が 20,000,000 ピクセル、JPEG／WebP が 80,000,000 ピクセルで、全画像の合計です。

デフォルト値"url"

指定可能な値

"url"
"b64_json"

output_compression?integer

JPEG／WebP の圧縮品質。値が高いほどファイルが大きくなります。PNG では無視されます。

範囲0 <= value <= 100

デフォルト値95

stream?boolean

SSE で画像ごとに結果を返すかどうか。response_format が url の場合のみ対応します。

デフォルト値false

aigc_watermark?boolean

可視 AIGC ウォーターマークを追加するかどうか。ファイルのメタデータに含まれる不可視識別子には影響しません。

デフォルト値false

image*array<>

参照画像は 1–16 枚。JPG、JPEG、PNG、WEBP、HEIC、HEIF に対応。画像単体とリクエスト本文全体はそれぞれ 64 MiB 以下。辺の長さは 128–8192 ピクセル、長辺と短辺の比率は 4:1 以下。Base64 エンコード後の容量も本文サイズに含まれます。ファイルごとに image フィールドを使用し、複数の場合は image[] も使用可能。アップロード順が画像番号になります。

項目数1 <= items <= 16

JSON による画像参照

JSON リクエストでは images オブジェクト配列で参照画像を送信します。他のフィールドはファイルアップロードと同じです。

フィールド	JSON 形式
`images[].image_url`	必須。公開 URL、Base64 Data URL、mm_file://{file_id} に対応します。サンプル URL は、画像生成後に保存した画像のアドレスに置き換えてください。

レスポンスボディ

`application/json`

type*string

created?integer

イベントの Unix タイムスタンプ。

model?string

実際に使用したモデル ID。

image_index*integer

0 から始まる画像インデックス。

範囲0 <= value

url*string

生成画像の一時リンク。

size?string

実際の画像の WIDTHxHEIGHT。

output_format?string

実際の出力形式。

指定可能な値

"jpeg"
"png"
"webp"

revised_prompt?string

その画像に使用したプロンプト。

curl -X POST "https://api.agtcloud.ai/v1/images/edits" \
  -H "Authorization: Bearer your-api-key" \
  -F model="MODEL_ID" \
  -F prompt="ライトの緑色のシェードをオフホワイトに変更し、木製テーブル、背景、光、構図を維持してください。" \
  -F size="2048x2048" \
  -F n="1" \
  -F response_format="url" \
  -F image="@/path/to/lamp.png"

{
  "created": 1794355200,
  "data": [
    {
      "url": "https://example.com/lamp-result.jpg",
      "size": "2048x2048",
      "revised_prompt": "明るい色の壁の前の木製テーブルに緑色のデスクライトが置かれ、柔らかい自然光がシェードと天板を照らしています。"
    }
  ],
  "output_format": "jpeg",
  "request_id": "REQUEST_ID"
}

クライアントのタイムアウトは 600 秒以上を推奨します。タイムアウトや切断後も生成が続く場合があり、再送すると新しいリクエストが作成されます。

MiniMax 画像編集 APIリクエストパラメータとレスポンス構造を確認します。

認証

リクエストボディ

JSON による画像参照

レスポンスボディ

200application/json

400application/json

401application/json

402application/json

422application/json

429application/json

ストリーミング応答イベント

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`