MiniMax H3 Image API
MiniMax H3 Image のテキストから画像を生成するモデルと画像編集モデルの完全な API リファレンス。
モデルの種類
この API は 2 種類のモデルに対応しています:
比較一覧
対応するアスペクト比
1:1, 1:2, 2:1, 1:3, 3:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9, 9:21, 21:9
ピクセル寸法ではなく、比率を個別の数値 width と height で指定してください。両方を省略すると、比率は既定で 1:1 になります。それ以外の場合は、対応する整数の組み合わせのいずれかを使用して、両方の値を指定してください。
MiniMax H3 Image(テキストから画像生成)
エンドポイント {#}
POST /api/v1/image/task
認証
Authorization: Bearer YOUR_API_KEY
リクエストパラメータ
必須
任意
注意: width:height の比率は、上記の対応する 15 種類の比率のいずれかである必要があります。
リクエスト例
const response = await fetch('https://api.flaq.ai/api/v1/image/task', {
method: 'POST',
headers: {
'Authorization': 'Bearer YOUR_API_KEY',
'Content-Type': 'application/json'
},
body: JSON.stringify({
model_name: 'minimax-h3-image',
prompt: 'A serene mountain landscape at sunset',
width: 16,
height: 9,
resolution: '2k',
output_format: 'png'
})
});
const { data } = await response.json();
const taskId = data.task_id;
MiniMax H3 Image Edit(画像編集)
エンドポイント
POST /api/v1/image/task
リクエストパラメータ
必須
任意
注意: width:height の比率は、上記の対応する 15 種類の比率のいずれかである必要があります。
リクエスト例
const response = await fetch('https://api.flaq.ai/api/v1/image/task', {
method: 'POST',
headers: {
'Authorization': 'Bearer YOUR_API_KEY',
'Content-Type': 'application/json'
},
body: JSON.stringify({
model_name: 'minimax-h3-image-edit',
prompt: 'Change the sky to sunset colors',
image_url_list: ['https://example.com/image.jpg'],
width: 16,
height: 9,
resolution: '2k',
output_format: 'png'
})
});
const { data } = await response.json();
const taskId = data.task_id;
単一画像の編集例
{
model_name: 'minimax-h3-image-edit',
prompt: 'Change the sky to sunset colors',
image_url_list: ['https://example.com/image.jpg'],
width: 16,
height: 9,
resolution: '2k',
output_format: 'png'
}
複数画像の合成例
{
model_name: 'minimax-h3-image-edit',
prompt: 'Combine these images into a cohesive landscape',
image_url_list: ['https://example.com/image1.jpg', 'https://example.com/image2.jpg'],
width: 16,
height: 9,
resolution: '2k',
output_format: 'png'
}
レスポンス形式
初期レスポンス
{
"code": 0,
"message": "success",
"data": {
"task_id": "{task_id}",
"response_url": "https://api.flaq.ai/api/v1/image/{task_id}",
"task_status": "submitted"
}
}
ポーリングレスポンス
GET /api/v1/image/{task_id} をポーリングしてステータスを確認します。成功したポーリングレスポンスでは、生成された画像の URL が data.task_result.images[].url に格納されます。
ステータス値
submitted:タスク受け付け済み
processing:画像生成中
succeed:画像生成完了
failed:画像生成失敗
ベストプラクティス
- 詳細なプロンプト:被写体、照明、構図を説明し、プロンプトは 5000 文字以内に収めてください
- 解像度の選択:すべてのリクエストで
1k、2k、または 4k を明示的に指定してください
- アスペクト比:
width と height に対となる比率値を指定するか、両方を省略して 1:1 を使用してください
- 画像編集の品質:対応する形式と寸法の要件を満たす参照画像を 1-16 枚指定してください