メインコンテンツへスキップ
POST

Authorizations

string
必須
すべてのエンドポイントは Bearer Token による認証が必要ですAPI キーの取得:API キー管理ページ にアクセスして API キーを取得してください使用時はリクエストヘッダーに以下を追加:

Body

string
デフォルト:"mai-image-2.7"
必須
画像生成モデル名両モデルの機能とパラメータはまったく同じです。
boolean
デフォルト:"false"
画像タスクを送信する前にコンテンツモデレーションを実行するかどうかを指定します。
  • true:omni-moderation-latest でプロンプトと入力画像を審査
  • false または省略:審査リクエストを行わず、審査コストや遅延を追加しない(デフォルト)
string
必須
画像生成のテキスト説明または編集指示
  • 中国語と英語に対応。詳しく記述することを推奨します
  • 最大 20,000 文字。超えると 400 を返します
  • 空文字や空白のみは指定できません
integer
デフォルト:"1"
生成する画像の枚数値:1
1 回につき 1 枚のみ生成できます。複数枚が必要な場合は個別にタスクを送信してください。0、負の数、または 1 より大きい値を指定すると 400 を返します
string
デフォルト:"1:1"
画像のアスペクト比またはピクセルサイズ。テキストから画像生成の場合のみ有効2 つの指定方法に対応します:
  • アスペクト比:1:4 から 4:1 の範囲の任意の整数比(1:1、16:9、9:16、21:9 など)。resolution と組み合わせて実際のピクセル数を決定します
  • ピクセルサイズ:幅x高さ(幅*高さ、幅×高さ も可)、例:2048x1152。この場合 resolution は無視されます
ピクセルサイズの制限:
  • 幅と高さはいずれも 768 以上
  • 幅 × 高さは 4,194,304 以下(2048×2048)
  • 幅と高さはそれぞれ 32 の倍数に切り下げられます。例:1000x1000 は 992x992 で出力されます
例:✅ 2048x2048、2048x1152、2560x1536;❌ 512x512(辺が 768 未満)、2080x2048(総ピクセル数が上限超過)
auto には対応していません。指定すると 400 を返します
string
デフォルト:"1K"
出力解像度の区分。size がアスペクト比の場合のみ有効選択肢:1K / 2K(小文字も可)size × resolution → 実際のピクセル数の対応表:
4K には対応していません。その他の区分を指定すると 400 を返します。短辺が最低 768 のため、2:1 より横長(または縦長)の比率では 1K でも実際のピクセル数が約 100 万を超えます。
integer
ピクセル単位の正確な幅。height と必ず同時に指定してください
  • 優先度が最も高く、同時に指定すると size と resolution を上書きします
  • 制限は size のピクセルサイズと同じ:幅と高さはいずれも 768 以上、総ピクセル数は 4,194,304 以下
  • テキストから画像生成の場合のみ有効
integer
ピクセル単位の正確な高さ。width と必ず同時に指定してください。制限は width と同じです
array
参照画像の配列。指定すると画像から画像生成モードになります
  • 1 枚なら単一画像の編集、複数枚なら複数画像の合成になります
string
背景タイプ選択肢:auto / opaque。指定しない場合と同じ結果になります
透過背景 transparent は現在未提供です。transparent またはその他の値を指定すると 400 を返します
auto_aspect_ratio: true、web_grounding: true には対応しておらず、指定すると 400 を返します。quality、style、output_format、response_format、mask_url は非対応で、指定しても無視されます。出力は PNG 固定です。

使用シナリオ例

テキストから画像生成(最小リクエスト) デフォルトは 1:1 + 1K で、1024×1024 を出力します。
テキストから画像生成(アスペクト比 + 2K を指定)
テキストから画像生成(ピクセル指定)
単一画像の編集
複数画像の合成(URL と base64 の混在)

Response

integer
レスポンスステータスコード
array
レスポンスデータ配列

タスク結果のクエリ

提出成功後に task_id が返されます。GET /v1/tasks/{task_id} でタスク状態をポーリングしてください。詳細は タスククエリ API を参照。ポーリングは 3–5 秒間隔、全体のタイムアウトは 3 分を推奨します。

成功レスポンス例

画像の取得方法:data.result.images[0].url[0]。画像リンクは expires_at を過ぎると失効するため、早めにダウンロードして保存してください。

タスクステータス