Image
MiniMax H3 Image Highspeed
最大 16 枚の参照画像、正確な寸法、1–10 枚の出力、トークン単位の料金で画像を生成・編集できます。
クイックサンプル
画像リクエストを 1 件送信し、返された id を保存して、タスクが completed または failed になるまでポーリングします。この API は非同期タスクを使用し、出力を URL で返します。
curl https://api.seedrouter.ai/v1/images/generations \
-H "Authorization: Bearer $SEEDROUTER_API_KEY" \
-H 'Content-Type: application/json' \
-d '{"model":"minimax-h3-image-highspeed","prompt":"An amber bottle on pale limestone in soft morning light","area":"1K","aspect_ratio":"3:2"}'エンドポイントとヘッダー
POST https://api.seedrouter.ai/v1/images/generations
| ヘッダー | 値 |
|---|---|
| Authorization | Bearer YOUR_API_KEY |
| Content-Type | application/json |
キーはサーバー上で保管してください。HTTP の成功応答はタスクが受け付けられたことを示しますが、画像の準備ができたことを意味するものではありません。
パラメーター
受け付けるフィールドは 13 個です。必須なのは model と prompt のみです。省略可能なフィールドを省略するとデフォルト値が使用されます。どのフィールドも null を受け付けません。Playground では固定のモデルと 10 個の編集可能な入力項目を提供しています。応答形式は URL、タスクの配信方式は非ストリーミングに固定されています。
| フィールド | 型 | デフォルト | 制約 |
|---|---|---|---|
model | 文字列 | 必須 | minimax-h3-image-highspeed |
prompt | 文字列 | 必須 | 前後の空白を除去した後で 1–32,000 Unicode 文字 |
images | オブジェクト配列 | 省略 | 順序付きの 1–16 個のオブジェクト。それぞれに image_url が必要です |
disable_prompt_enhanced | 真偽値 | false | 生成時のみ。以下の依存関係を参照してください |
n | 整数 | 1 | 1–10 |
size | 文字列 | auto | auto または WIDTHxHEIGHT。x は小文字です |
aspect_ratio | 文字列 | auto | auto または X:Y。X と Y は 1–300 の整数。比率は 1:3–3:1 |
area | 文字列 | 4K | 1K、2K、4K。目標面積の目安は 1,024²、2,048²、4,096² ピクセル |
output_format | 文字列 | jpeg | jpeg、その別名 jpg、png |
output_compression | 整数 | 95 | 0–100。JPEG の品質。PNG では無視されます |
aigc_watermark | 真偽値 | false | AI 生成コンテンツの透かしを追加します |
response_format | 文字列 | url | url のみ |
stream | 真偽値 | false | false のみ。タスク ID を使ってポーリングします |
サイズとプロンプトの依存関係
size を明示する場合、寸法は正の整数で、面積は 655,360 以上 20,000,000 以下のピクセルでなければなりません。幅を高さで割った値は 1/3 以上 3 以下である必要があります。例えば、2048x1152 は有効です。寸法を明示する場合は、値が auto であっても、aspect_ratio と area の両方を省略してください。
サイズを省略するか auto にする場合は、aspect_ratio と area を併用します。面積は目標サイズです。正確な寸法は配信されたファイルを確認してください。固定の画像 1 枚あたりの料金を意味するものではありません。
disable_prompt_enhanced: true を設定するには、明示的なピクセルサイズまたは固定のアスペクト比が必要です。強化を無効にすると、モデルはプロンプトの先頭約 4,096 トークンを読み取ります。送信時の 32,000 文字の上限は引き続き適用されます。編集時は常にプロンプトが強化されるため、images がある場合は true が拒否されます。
マスク、シード、スタイル、品質、ネガティブプロンプト、背景、独立した解像度フィールドは受け付けません。不明なパラメーターは送信前にエラーを返します。この API はストリーミング、base64 画像、WebP 出力を提供していません。
参照画像
認証情報を埋め込んでいない、公開アクセス可能な HTTP(S) URL を使用してください。各画像は JPEG、PNG、WebP、HEIC、HEIF のいずれかで、最大 64 MiB、各辺が 128–8,192 ピクセル、長辺と短辺の比率が最大 4 でなければなりません。JSON 本文は 64 MiB 以下にしてください。画像ファイルは URL で参照し、バイトデータは JSON 本文に埋め込みません。
各参照画像に明確な役割を割り当て、何を変更せずに保持するかを記述してください。配列の順序が <Picture 1>、<Picture 2> などに対応します。
{
"model": "minimax-h3-image-highspeed",
"prompt": "Use <Picture 1> as the product and <Picture 2> as the setting. Preserve the product's shape and label. Match the setting's light and perspective.",
"images": [
{"image_url": "https://example.com/product.jpg"},
{"image_url": "https://example.com/setting.jpg"}
],
"aspect_ratio": "3:2",
"area": "2K",
"n": 1,
"output_format": "png"
}例示用の URL を、ご自身のアクセス可能な画像ファイルの URL に置き換えてください。
料金
料金には、テキスト入力、画像入力、画像出力の 3 種類のトークン区分があります。各区分の実際の使用量に、その時点の料金を掛けます。出力枚数、画像の寸法、参照画像が使用量に影響します。解像度名で請求額が固定されるわけではありません。失敗したリクエストには課金されません。最新の料金を参照してください。
タスク応答とポーリング
受け付けられたリクエストは非同期タスクを返します。
{"id":"task_example","model":"minimax-h3-image-highspeed","status":"processing"}curl https://api.seedrouter.ai/v1/tasks/task_example \
-H "Authorization: Bearer $SEEDROUTER_API_KEY"完了した応答では、output.data に画像 URL が含まれます。配信される各画像には size が含まれ、revised_prompt（強化された説明）が含まれる場合もあります。output.created は Unix 秒で表した作成時刻で、output.output_format は配信形式を示します。output.usage は、テキスト入力、画像入力、画像出力のトークン数と、配信された generated_images の数を示します。以下の URL と ID は例示用です。
{
"id": "task_example",
"model": "minimax-h3-image-highspeed",
"status": "completed",
"output": {"data": [{"url": "https://file.deepytb.com/generated/example.jpg"}]}
}10–20 秒ごとにポーリングしてください。クライアントのタイムアウトはタスクの失敗を意味しません。重複するリクエストを送信せず、ID を保持してポーリングを続けてください。公開応答にはアカウント残高や費用は含まれません。
エラー
HTTP エラーは {"error":{"code":integer,"message":string}} 形式を使用します。失敗したタスクには status: "failed" とエラーが含まれます。新たに送信する前に無効なパラメーターを修正してください。共通エラー一覧とタスクのライフサイクルを参照してください。