メインコンテンツへスキップ
POST
model: "kling-v4-image" を指定して POST /v1/images/generations に非同期タスクを送信します。data[0].task_id を取得し、GET /v1/tasks/{task_id} で結果を確認します。

認証

string
必須
Authorization: Bearer <token> を使用します。<token> は APIMart API キーです。

リクエストパラメータ

string
必須
kling-v4-image を指定します。
boolean
デフォルト:"false"
画像タスクを送信する前にコンテンツモデレーションを実行するかどうかを指定します。
  • true:omni-moderation-latest でプロンプトと入力画像を審査
  • false または省略:審査リクエストを行わず、審査コストや遅延を追加しない(デフォルト)
string
必須
テキストからの生成、参照画像を使う生成、シリーズ生成のすべてで必須です。含めたい内容と避けたい内容を記述できます。英語のみの場合は最大 50,000 文字、中国語などのみの場合は最大 21,000 文字。複数言語が混在する場合は比率に応じて計算されます。
string[]
公開アクセス可能な画像の直接 URL を最大 10 件指定します。ローカルファイルは画像アップロード APIでアップロードし、返された url を指定できます。JPG / JPEG / PNG / GIF に対応。1 枚あたり 30 MB 以下、幅・高さともに 300 px 以上、アスペクト比は 2:5–5:2。送信時に参照画像を検証します。URL が HTTP 403 / 404 / 410 を返す、いずれかの辺が 300 px 未満、比率が 2:5–5:2 の範囲外、または 30 MB 超の場合、即座に HTTP 400 を返します。タスクは作成されず、生成料金も発生しません。配信元のタイムアウトなど、その他の取得エラーは一旦受理した後にタスクが失敗し、事前に引き落とした生成料金は全額返金されます。プロンプト内で @Image1、@Image2 などを使うと配列順に画像を指定できます。これらの記号を省略しても入力画像は参照されます。
integer
デフォルト:"1"
通常モードの出力枚数。1–9 の整数で、デフォルトは 1。シリーズモードでは n を省略するか 1 を指定でき、出力枚数は sequential_image_generation_options.max_images で決まります。シリーズで n > 1 を指定すると HTTP 400 が返ります。
string
デフォルト:"2K"
2K(デフォルト)、4K、8K に対応し、大文字・小文字は区別しません。出力は PNG です。1:1 の場合、2K は 2048×2048、4K は 4096×4096、8K は 8192×8192。その他の比率では返された画像の実際の寸法を確認してください。8K でもテキストからの生成、参照画像を使う生成、シリーズ生成に対応します。通常生成は 1–9 枚、シリーズは 2–4 枚、参照画像は最大 10 枚です。参照画像の形式・寸法条件と 1 枚あたり 30 MB の上限は変わりません。
string
デフォルト:"auto"
出力アスペクト比。auto(デフォルト)と次の 8 種類に対応します。16:9、9:16、1:1、4:3、3:4、3:2、2:3、21:9。auto はプロンプトや参照画像に応じて比率を決めます。2048x2048 などのピクセル寸法は指定できません。
string
size の別名で、同じ値を指定できます。両方を指定した場合は aspect_ratio が優先されます。
string
デフォルト:"disabled"
disabled または省略で通常生成。auto にすると関連する画像をシリーズとして生成し、sequential_image_generation_options.max_images が必須になります。この auto は枚数の自動決定を意味しません。
object
シリーズモードの枚数を指定するオブジェクト。
width、height、mask_url、ピクセル形式の size、watermark: true は非対応で、指定すると HTTP 400 が返ります。

リクエスト例

以下は POST /v1/images/generations に送信します。画像 URL は実際にアクセスできる直接リンクに置き換えてください。

参照画像を使った生成

4K 画像を 3 枚生成

8K 画像を 1 枚生成

関連する 8K 画像 4 枚のシリーズを生成

シリーズでは max_images に 2–4 を指定します。n は省略または 1 にでき、1 を超える値は指定できません。数分かかる場合があるため、task_id を保存して状態を確認し、同じリクエストの再送は避けてください。

8K 出力と所要時間の例

以下はテスト環境での実測例です。寸法、ファイルサイズ、所要時間は参考値であり、実際の結果によって異なります。 completed または failed になるまで 5–10 秒間隔で照会してください。estimated_time は 60 秒固定であり、実際の完了予測やカウントダウンには使用できません。task_id を保存し、待機中の重複送信を避けてください。 8K の結果は PNG 原画像で、1 ファイルが 100 MB を超える場合があります。一覧やプレビューでは自分で生成したサムネイルを使うか、必要時に読み込んでください。原画像のダウンロード導線を用意し、ファイルサイズが大きいことを表示してください。

タスクの確認

タスク照会 API の data.status を確認します。pending / processing は処理中、completed は成功です。failed の場合は data.error.message を参照します。
以下は成功結果の構造例です。画像 URL は data.result.images[].url[] にあり、url は配列です。すべての出力を取得し、早めにダウンロードしてください。

料金

実際の出力枚数と選択した解像度に応じて課金されます。参照画像は別途 1 枚ごとに課金されます。単価は料金ページを確認してください。
  • 通常生成で n=3 の場合は出力 3 枚分、シリーズは実際に返された枚数分を課金します。
  • 各参照画像はリクエストごとに 1 回だけ計上し、出力枚数では乗算しません。参照画像 2 枚から 3 枚生成する場合、入力 2 枚と出力 3 枚分です。
  • 生成に失敗したタスクの生成料金は発生せず、事前に引き落とした生成料金は全額返金されます。

よくあるパラメータエラー

以下のエラーは送信時に同期的に HTTP 400 を返し、タスクを作成せず、生成料金も発生しません。送信エラーは error.message、タスク作成後の失敗は data.error.message を確認します。