MiniMax H3 Image

クイックサンプル

画像リクエストを 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","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

キーはサーバー上で保管してください。HTTP の成功応答はタスクが受け付けられたことを示しますが、画像の準備ができたことを意味するものではありません。

パラメーター

受け付けるフィールドは 13 個です。必須なのは model と prompt のみです。省略可能なフィールドを省略するとデフォルト値が使用されます。どのフィールドも null を受け付けません。Playground では固定のモデルと 10 個の編集可能な入力項目を提供しています。応答形式は URL、タスクの配信方式は非ストリーミングに固定されています。

サイズとプロンプトの依存関係

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",
  "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","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",
  "status": "completed",
  "output": {"data": [{"url": "https://file.deepytb.com/generated/example.jpg"}]}
}

10–20 秒ごとにポーリングしてください。クライアントのタイムアウトはタスクの失敗を意味しません。重複するリクエストを送信せず、ID を保持してポーリングを続けてください。公開応答にはアカウント残高や費用は含まれません。

エラー

HTTP エラーは {"error":{"code":integer,"message":string}} 形式を使用します。失敗したタスクには status: "failed" とエラーが含まれます。新たに送信する前に無効なパラメーターを修正してください。共通エラー一覧とタスクのライフサイクルを参照してください。

関連ページ

• MiniMax H3 Image Playground と料金
• MiniMax H3 Image Highspeed