curl --request POST \
  --url https://api.evolink.ai/v1/images/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "minimax-h3-image",
  "prompt": "海面に広がる色鮮やかな美しい夕焼け"
}
'

{
  "created": 1757156493,
  "id": "task-unified-1757156493-imcg5zqt",
  "model": "minimax-h3-image",
  "object": "image.generation.task",
  "progress": 0,
  "status": "pending",
  "task_info": {
    "can_cancel": true,
    "estimated_time": 100
  },
  "type": "image",
  "usage": {
    "billing_rule": "per_call",
    "credits_reserved": 2.5,
    "user_group": "default"
  }
}

{
  "error": {
    "code": "invalid_request",
    "message": "Invalid request parameters",
    "type": "invalid_request_error"
  }
}

{
  "error": {
    "code": "unauthorized",
    "message": "Invalid or expired token",
    "type": "authentication_error"
  }
}

{
  "error": {
    "code": "insufficient_quota",
    "message": "Insufficient quota. Please top up your account.",
    "type": "insufficient_quota"
  }
}

{
  "error": {
    "code": "model_access_denied",
    "message": "Token does not have access to model: minimax-h3-image",
    "type": "invalid_request_error"
  }
}

{
  "error": {
    "code": "rate_limit_exceeded",
    "message": "Too many requests, please try again later",
    "type": "rate_limit_error"
  }
}

{
  "error": {
    "code": "internal_error",
    "message": "Internal server error",
    "type": "api_error"
  }
}

Minimax

MiniMax H3 Image 画像生成

MiniMax H3 Image (minimax-h3-image) はテキストからの画像生成と画像編集に対応し、最大16枚の参照画像を指定できます
最大2000万ピクセルで出力：アスペクト比と 1K / 2K / 4K の解像度を組み合わせるか、幅と高さをピクセルで直接指定できます
非同期処理：返されたタスクIDを使用してタスクを照会してください
生成画像のリンクは24時間有効です。早めに保存してください

POST

images

generations

curl --request POST \
  --url https://api.evolink.ai/v1/images/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "minimax-h3-image",
  "prompt": "海面に広がる色鮮やかな美しい夕焼け"
}
'

{
  "created": 1757156493,
  "id": "task-unified-1757156493-imcg5zqt",
  "model": "minimax-h3-image",
  "object": "image.generation.task",
  "progress": 0,
  "status": "pending",
  "task_info": {
    "can_cancel": true,
    "estimated_time": 100
  },
  "type": "image",
  "usage": {
    "billing_rule": "per_call",
    "credits_reserved": 2.5,
    "user_group": "default"
  }
}

{
  "error": {
    "code": "invalid_request",
    "message": "Invalid request parameters",
    "type": "invalid_request_error"
  }
}

{
  "error": {
    "code": "unauthorized",
    "message": "Invalid or expired token",
    "type": "authentication_error"
  }
}

{
  "error": {
    "code": "insufficient_quota",
    "message": "Insufficient quota. Please top up your account.",
    "type": "insufficient_quota"
  }
}

{
  "error": {
    "code": "model_access_denied",
    "message": "Token does not have access to model: minimax-h3-image",
    "type": "invalid_request_error"
  }
}

{
  "error": {
    "code": "rate_limit_exceeded",
    "message": "Too many requests, please try again later",
    "type": "rate_limit_error"
  }
}

{
  "error": {
    "code": "internal_error",
    "message": "Internal server error",
    "type": "api_error"
  }
}

承認

Authorization

string

header

必須

##すべてのAPIにBearer Token認証が必要です##

APIキーの取得：

APIキー管理ページにアクセスしてAPIキーを取得してください

リクエストヘッダーに追加：

Authorization: Bearer YOUR_API_KEY

ボディ

application/json

model

enum<string>

デフォルト:minimax-h3-image

必須

画像生成モデル名。公式チャネルは安定性と制御性に優れ、商用利用に適しています

利用可能なオプション:

minimax-h3-image

例:

"minimax-h3-image"

prompt

string

必須

生成する画像、または入力画像の編集方法を記述するプロンプト

長さの制限：

最大 32,000 文字（Unicodeコードポイント単位で計測）
prompt_extend が false の場合、プロンプトの先頭約 4096 トークンのみが有効です

Maximum string length: 32000

例:

"海面に広がる色鮮やかな美しい夕焼け"

image_urls

string<uri>[]

画像からの画像生成と画像編集に使用する参照画像URLのリスト

注意：

1リクエストあたりの入力画像数：1~16 枚
画像1枚あたりの最大ファイルサイズ：64MB
各画像の幅と高さ：どちらも 128 ～ 8192 px
各画像のアスペクト比：長辺 / 短辺が 4:1 以下
対応形式：.jpeg、.jpg、.png、.webp、.heic、.heif
画像URLはサーバーから直接アクセスできるか、アクセス時に直接ダウンロードが開始される必要があります（通常、このようなURLは .png や .jpg などの拡張子で終わります）
画像からの画像生成や画像編集では、参照画像に対して追加の画像入力トークンが発生します

例:

[
  "https://example.com/image1.png",
  "https://example.com/image2.png"
]

size

string

デフォルト:auto

生成画像のサイズ。アスペクト比またはピクセル数の直接指定に対応します。デフォルトは auto

① アスペクト比（推奨）： X:Y。主な比率：

1:1：正方形
1:2 / 2:1：縦長 / 横長
1:3 / 3:1：超縦長 / 超横長（上限の3:1）
2:3 / 3:2：標準的な縦向き / 横向き
3:4 / 4:3：従来の縦向き / 横向き
4:5 / 5:4：SNSでよく使われる比率
9:16 / 16:9：スマートフォン / デスクトップのワイド画面
9:21 / 21:9：ウルトラワイド形式

その他の X:Y も指定できます。X と Y は 1 ～ 300 の整数で、アスペクト比は ≤ 3:1 にする必要があります

② ピクセル数の直接指定： WxH（または W×H）。例：1024x1024、2720x1536、5472x3072

総ピクセル数：655,360 ≤ width × height ≤ 20,000,000（約0.65 MP ～ 20 MP）
アスペクト比：≤ 3:1

③ auto：モデルがアスペクト比を自動選択します。出力面積は引き続き resolution の設定に従います

範囲外のサイズ：

上記の範囲外のサイズは 400 を返します。自動的な拡大縮小や丸めは行いません

例:

"auto"

resolution

enum<string>

デフォルト:2K

解像度を簡単に指定するパラメータ。size が auto またはアスペクト比の場合に有効で、ピクセル数を直接指定した場合は無視されます

総ピクセル数の規則（目標の総ピクセル数と size の比率から幅と高さを計算）：

1K：約1 MP（1024² = 1,048,576 ピクセル）
2K：約4 MP（2048² = 4,194,304 ピクセル）
4K：約16.8 MP（4096² = 16,777,216 ピクセル）

横向き / 正方形の実際の出力サイズ（縦向きは対応する幅と高さを入れ替えます。例：3:4 は 4:3 の反転）：

アスペクト比	2K	4K
`1:1`	2048×2048	4096×4096
`4:3`	2368×1760	4736×3552
`16:9`	2720×1536	5472×3072
`3:1`	3552×1184	7104×2368

注意：

1K と 2K の画像出力トークン数は同じです（1枚あたり約 4,096）。4K は1枚あたり約 16,384 で、返された usage が基準となります
大文字と小文字は区別しません

利用可能なオプション:

1K,

2K,

4K

例:

"2K"

output_format

enum<string>

デフォルト:jpeg

出力画像のファイル形式。デフォルトは jpeg

jpeg：非可逆圧縮でファイルサイズが小さい
png：可逆形式
webp：ファイルサイズと画質のバランスを重視

注意：

透明な背景には対応していません

利用可能なオプション:

jpeg,

png,

webp

例:

"jpeg"

integer

デフォルト:1

生成する画像の枚数。各画像は個別に課金されます

注意：

テキスト入力トークンと画像入力トークンは、どちらも n に比例して増加します
一部の画像が失敗した場合（コンテンツ安全性チェックなど）でも、成功した画像を含めてタスクは完了します。実際の枚数はレスポンスの results に従い、課金は返された usage に基づきます

必須範囲: 1 <= x <= 10

例:

1

prompt_extend

boolean

デフォルト:true

プロンプト最適化：生成前にモデルがプロンプトをより詳細に書き換えます。デフォルトは true

注意：

テキストからの画像生成で、size がアスペクト比またはピクセル数の直接指定の場合にのみ false に設定できます
size が auto、または image_urls が指定されている場合、false にすると 400 を返します
有効にすると、画像1枚あたり約 2,300 ～ 3,800 のテキスト入力トークンが追加されます。無効の場合は元のプロンプトのみが計測されます

例:

true

callback_url

string<uri>

タスク完了後の HTTPS コールバックアドレス

コールバックタイミング：

タスクが完了、失敗、またはキャンセルされた時にトリガーされます
課金確認完了後に送信されます

セキュリティ制限：

HTTPS プロトコルのみサポート
内部 IP アドレスへのコールバックは禁止（127.0.0.1、10.x.x.x、172.16-31.x.x、192.168.x.x など）
URL の長さは 2048 文字以内

コールバックメカニズム：

タイムアウト：10 秒
失敗時最大 3 回リトライ（1 秒/2 秒/4 秒後にリトライ）
コールバックレスポンスボディの形式はタスククエリ API のレスポンス形式と一致
コールバックアドレスが 2xx ステータスコードを返した場合は成功とみなされ、その他のステータスコードはリトライをトリガーします

例:

"https://your-domain.com/webhooks/image-task-completed"

レスポンス

画像タスクが正常に作成されました

created

integer

タスク作成タイムスタンプ

例:

1757156493

string

タスクID

例:

"task-unified-1757156493-imcg5zqt"

model

string

実際に使用されたモデル名

例:

"minimax-h3-image"

object

enum<string>

具体的なタスクタイプ

利用可能なオプション:

image.generation.task

progress

integer

タスク進行状況のパーセンテージ (0-100)

必須範囲: 0 <= x <= 100

例:

0

status

enum<string>

タスクステータス

利用可能なオプション:

pending,

processing,

completed,

failed

例:

"pending"

task_info

object

非同期タスク情報

Show child attributes

type

enum<string>

タスクの出力タイプ

利用可能なオプション:

text,

image,

audio,

video

例:

"image"

usage

object

使用量と課金情報

Show child attributes

画像シリーズ

動画シリーズ

オーディオシリーズ

テキストシリーズ

アカウント管理

タスク管理

ファイル管理

MiniMax H3 Image 画像生成

承認

ボディ

レスポンス