メインコンテンツへスキップ
POST
model: "kling-v4-long-image" を指定して POST /v1/images/generations に非同期タスクを送信します。data[0].task_id を取得し、GET /v1/tasks/{task_id} で結果を確認します。毎回 1 枚の縦長 PNG を返し、ウェブページモードではページデザイン画像を生成します。

モード選択

認証

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

リクエストパラメータ

string
必須
kling-v4-long-image を指定します。
boolean
デフォルト:"false"
画像タスクを送信する前にコンテンツモデレーションを実行するかどうかを指定します。
  • true:omni-moderation-latest でプロンプトと入力画像を審査
  • false または省略:審査リクエストを行わず、審査コストや遅延を追加しない(デフォルト)
string
必須
必須で、空白のみは不可。英語のみの場合は最大 166,000 文字、中国語などのみの場合は最大 71,000 文字。混在する場合は比率に応じて計算します。レイアウト、セクション、文言、スタイル、被写体を記述できます。
string
必須
必須。ecommerce(商品詳細ページ)または webpage(ウェブページデザイン)を指定し、大文字・小文字は区別しません。参照画像のフィールドはモードごとに異なります。
string
デフォルト:"medium"
skill: "ecommerce" 専用。short、medium(デフォルト)、long は、おおよそ 2–5、6–10、11–18 セクションに対応します。実際の内容と高さは生成結果によります。ウェブページモードでは省略してください。指定すると HTTP 400 になります。
string
デフォルト:"1K"
1K(デフォルト)と 2K に対応し、大文字・小文字は区別しません。商品ページはすべての長さで両方を利用でき、long + 2K も対応します。出力幅はそれぞれ 1024 px と 2048 px、高さは内容に応じて変わります。4K は非対応です。
string[]
商品ページ専用で、商品画像 1–3 枚が必須。ウェブページでは省略し、image_with_roles を使用してください。公開アクセス可能な画像の直接 URL を指定します。ローカルファイルは画像アップロード APIでアップロードし、返された url を指定できます。
object[]
ウェブページ専用で省略可能。style と subject は各最大 1 枚で、片方または両方を省略できます。商品ページではこのフィールドを省略してください。
integer
毎回 1 枚の縦長画像を生成します。省略または整数 1 のみ指定でき、その他の値は HTTP 400 になります。
boolean
省略または false を指定できます。true は HTTP 400 になります。
size、aspect_ratio、width、height、mask_url、sequential_image_generation、sequential_image_generation_options は指定できません。null や空文字列でも HTTP 400 になります。

参照画像の要件と指定方法

JPG / JPEG / PNG に対応。1 枚あたり 30 MB 以下、幅・高さともに 300 px 以上、比率は 2:5–5:2。URL が HTTP 403 / 404 / 410 を返す、寸法・比率が不適切、または容量超過の場合は同期的に HTTP 400 を返し、タスク作成も生成課金も行いません。配信元のタイムアウトなどは一旦受理後にタスクが失敗し、事前引き落とし分が返金されます。 プロンプトでは @Image1、@Image2 などを使用できます。商品ページは image_urls の順、ウェブページはスタイル、被写体の順です。片方のみ指定した場合は @Image1 です。

リクエスト例

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

商品ページ:long + 2K

スタイルと被写体を参照したウェブページ

プロンプトのみでウェブページを生成

タスクの確認

タスク照会 API を約 10 秒間隔で確認します。task_id を保存し、待ち時間が長くても生成リクエストを重複送信しないでください。
以下は成功結果の構造例です。images と url は配列で、このモデルは毎回 1 枚の縦長画像を返します。
data.result.images[0].expires_at の Unix 秒タイムスタンプまでにダウンロードしてください。それ以降はリンクが失効します。
生成には通常数分かかり、long + 2K の実測例は 432 秒でした。estimated_time は現在 60 秒固定のため、完了までのカウントダウンやタイムアウト判定に使用しないでください。所要時間は内容と負荷で変わり、実測例は上限ではありません。高さとファイル容量は内容に応じて変わります。long + 2K の一例は 2048×46615、63.9 MB でした。これは出力上限ではありません。結果が 50 MB を超える場合もあるため、ダウンロードと大きな画像の表示に配慮してください。

料金

毎回、選択した出力区分の長尺画像 1 枚分と参照画像分を課金します。出力区分の単価 + 参照枚数 × 参照画像単価。商品・スタイル・被写体の画像はすべて対象で、最初の参照画像も課金されます。 出力は以下の 8 区分です。料金キーは kling-v4-long-image@<区分>、参照画像は kling-v4-long-image@input です。生成リクエストの resolution には引き続き 1K または 2K のみ指定します。 送信時に事前引き落とし、成功時に確定し、失敗時は全額返金します。単価とアカウント割引は料金ページをご確認ください。

よくあるエラー

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