画像を作成

POST/v1/images/generations

テキストプロンプトから画像を生成します。

認証

bearerAuth

認証Bearer <token>

プラットフォームの API Key を使用します。形式は Authorization: Bearer your-api-key です。

指定位置: header

リクエストボディ

application/json

TypeScript 型定義

TypeScript で request body 型を使用します。

model*string

プラットフォームのモデル ID。

prompt*string

画像生成または編集のプロンプト。前後の空白を除く Unicode 文字数で数え、空白のみは指定できません。

長さ1 <= length <= 32000

n?integer

生成する画像の枚数。

範囲1 <= value <= 10

デフォルト値1

size?string

auto または WIDTHxHEIGHT。デフォルトは auto。指定面積は 655,360–20,000,000 ピクセル、縦横比は 1:3–3:1。幅と高さを指定する場合は aspect_ratio と area を省略します。

デフォルト値"auto"

aspect_ratio?string

デフォルトは auto。拡張されたプロンプトで決まり、編集時は参照画像も考慮します。X:Y も指定可能で、X、Y は 1–300 の整数、比率は 1:3–3:1。size の省略時または auto の場合のみ使用します。

area?string

面積のプリセット。デフォルトは 4K。size の省略時または auto の場合のみ使用し、実際の寸法は data[].size に返されます。

指定可能な値

"1K"
"2K"
"4K"

output_format?string

画像形式。jpg と jpeg は同等で、レスポンスは jpeg に統一されます。

デフォルト値"jpeg"

指定可能な値

"jpeg"
"jpg"
"png"
"webp"

response_format?string

url リンクの有効期間は 24 時間。b64_json は Base64 を返し、ストリーミングには対応しません。Base64 の総出力面積上限は PNG が 20,000,000 ピクセル、JPEG／WebP が 80,000,000 ピクセルで、全画像の合計です。

デフォルト値"url"

指定可能な値

"url"
"b64_json"

output_compression?integer

JPEG／WebP の圧縮品質。値が高いほどファイルが大きくなります。PNG では無視されます。

範囲0 <= value <= 100

デフォルト値95

stream?boolean

SSE で画像ごとに結果を返すかどうか。response_format が url の場合のみ対応します。

デフォルト値false

aigc_watermark?boolean

可視 AIGC ウォーターマークを追加するかどうか。ファイルのメタデータに含まれる不可視識別子には影響しません。

デフォルト値false

disable_prompt_enhanced?boolean

プロンプト拡張を無効化するかどうか。無効時は先頭の約 4,096 Token のみ有効で、具体的な size または固定の aspect_ratio が必要です。

デフォルト値false

レスポンスボディ

`application/json`

type*string

created?integer

イベントの Unix タイムスタンプ。

model?string

実際に使用したモデル ID。

image_index*integer

0 から始まる画像インデックス。

範囲0 <= value

url*string

生成画像の一時リンク。

size?string

実際の画像の WIDTHxHEIGHT。

output_format?string

実際の出力形式。

指定可能な値

"jpeg"
"png"
"webp"

revised_prompt?string

その画像に使用したプロンプト。

curl -X POST "https://example.com/v1/images/generations" \
  -H "Authorization: Bearer your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "MODEL_ID",
    "prompt": "木製テーブルの上にある緑色のデスクライトの写真を生成してください。背景は明るい色の壁で、柔らかい自然光にしてください。",
    "size": "2048x2048",
    "n": 1,
    "response_format": "url"
  }'

{
  "created": 1794355200,
  "data": [
    {
      "url": "https://example.com/lamp-result.jpg",
      "size": "2048x2048",
      "revised_prompt": "明るい色の壁の前の木製テーブルに緑色のデスクライトが置かれ、柔らかい自然光がシェードと天板を照らしています。"
    }
  ],
  "output_format": "jpeg",
  "request_id": "REQUEST_ID"
}

クライアントのタイムアウトは 600 秒以上を推奨します。タイムアウトや切断後も生成が続く場合があり、再送すると新しいリクエストが作成されます。

MiniMax 画像生成 APIリクエストパラメータとレスポンス構造を確認します。

認証

リクエストボディ

レスポンスボディ

200application/json

400application/json

401application/json

402application/json

422application/json

429application/json

ストリーミング応答イベント

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`