はじめに
商品写真をアップロードして訴求ポイントを挙げると、完成した詳細ページが返ります。ページの長さと、ストアに合った解像度を選べます。
| 項目 | 値 |
|---|---|
| 入力 | 画像 |
| 出力 | 画像 |
| 公開元 | Kling |
| 公開日 | 2026年11月17日 |
| ページの用途 | Webページデザイン、EC商品詳細ページ |
| プロンプトの長さ | どちらの用途も1〜71,000文字 |
| 解像度の選択肢 | 1k(既定値)、2k |
| 商品詳細ページの長さ | short、medium(既定値)、long |
| Webページの参考画像数 | 0〜3枚 |
| 必須の商品写真数 | 1〜3枚 |
| 入力画像の要件 | JPGまたはPNG、30 MB以下、各辺300 px以上、比率2:5〜5:2 |
| 記録されたWebページ出力 | 2kで2048 x 16469のPNG |
| 記録された商品ページ出力 | short、1kで1024 x 5021のPNG |
主な機能とハイライト
陶芸の指示書からページ全体の画像へ
Tideline Ceramicsのリクエストでは、メイン見出し、鉢、工房紹介、フッターを指定しました。返された2kのPNGは2048 x 16469で、これらのセクションを含んでいます。この長さのページを再利用する前に、小さな本文を確認してください。
ローズの写真を中心にした短いレイアウト
プリザーブドローズのリクエストでは、提供した商品画像、shortのページ長、1kの解像度を使いました。その写真を中心とする商品詳細ページとして、1024 x 5021のPNGが1枚返されました。
各セクションに役割と文言を指定します
どちらのエンドポイントも71,000文字までのプロンプトに対応します。読む順序、支給する文章、参照画像の役割を具体的に記載してください。Webサイトの参考画像は任意ですが、商品詳細ページには商品写真が1〜3枚必要です。
長さと解像度を分けて選びます
どちらの用途でも1kと2kを選べ、既定値は1kです。商品詳細ページにはshort、medium、longの長さの選択肢もあります。これらの設定でページ料金が変わり、入力画像ごとに少額の入力料金もかかります。
リクエストパラメーター
| パラメーター | 必須 | 説明 |
|---|---|---|
prompt | はい | 必須で、71,000 文字まで入力できます。商品情報、訴求ポイント、モジュールの順序を書き、写真は @ |
image_urls | はい | 商品写真を 1〜3 枚指定する必要があります。写真は JPG または PNG 形式とし、30 MB 以下、各辺 300 px 以上、縦横比 2:5 から 5:2 に収めてください。 1 件以上 · 3 件以内 |
page_length | いいえ | ページの長さで、short、medium、long から選びます。既定は medium で、長いページほど料金が上がります。 |
resolution | いいえ | ページの解像度で、1k または 2k を選びます。既定は 1k です。 |
料金
完成したページ 1 枚ごとに、長さと解像度に応じた料金が発生します。商品写真 1 枚ごとに少額の入力料金が加算されます。
| 解像度 | Page length: short | Page length: medium | Page length: long |
|---|---|---|---|
| $0.235 / 枚 | $0.47 / 枚 | $0.784 / 枚 |
| $0.282 / 枚 | $0.549 / 枚 | $0.862 / 枚 |
ユースケース
陶芸工房のWebサイト案
陶芸事業のメインビジュアル、注目の鉢、工房の紹介、営業時間を指定します。Tideline Ceramicsの実行では、これらを含む2048 x 16469のPNGが1枚返されました。再利用前に小さな本文の確認が必要です。
ギフト商品の詳細レイアウト
商品写真を添え、メインビジュアル、訴求点、お手入れ方法、ギフトメッセージ欄を依頼します。プリザーブドローズのshort設定では、提供写真を中心に構成した1024 x 5021のPNGが1枚返されました。
デザイン引き継ぎのためのブランド方針
任意の参考画像で配色や被写体を伝え、プロンプトで対象読者とセクションの順序を指定します。Webサイトの実装前に、生成されたページ画像をチームで確認してください。
ページの長さに合わせた商品紹介の指示
店舗の商品について確認済みの情報をモジュールに分け、short、medium、longを選びます。選択した長さに文章量を合わせ、生成ページで事実の欠落や変更がないか確認します。
プロンプトガイドと実践のヒント
目的に合うエンドポイントを選びます
文章でサイトの見た目を指定する場合はWebページデザインを選び、必要に応じて参考画像を添えます。商品写真と確認済みの訴求点がある場合は、商品詳細エンドポイントを使います。
上から下へ読む順番で指示します
モジュールを読む順に並べ、それぞれの見出し、本文、ボタンの文言を引用します。番号付きの各参照画像が何を示し、どう使うかも説明してください。
ページの設定を決めます
どちらのエンドポイントでも1kまたは2kを選べます。商品詳細ページではshort、medium、longも指定でき、既定値はmediumです。
ダウンロードしたページを確認します
読みやすいサイズで画像を表示し、文言や商品の訴求内容を指示書と照合します。デザイナーへの引き継ぎや掲載用画像の準備前に、モジュール間の流れも確認してください。
提供写真を中心に商品紹介を構成します
このエンドポイントは、商品写真と商品紹介の指示から、つながった詳細ページ画像を構成します。買い手に商品を見てもらい、提供した訴求点を理解し、モジュールの流れに沿って情報を読んでもらう場合に使います。写真と一緒に商品情報を用意し、ページで何を伝えるかを指示書で定めてください。
Webページデザインとは異なり、商品写真が必須で、ページの長さを設定できます。結果は確認用や掲載画像の準備に使う平面的なページ画像です。編集可能な店舗ページや、モジュール別のファイルは含まれません。
商品の入力とページ設定
長さと解像度を選ぶ前に、画像と確認済みの文章を準備します。両方の設定がページ料金に影響し、アップロードした商品写真にも入力料金がかかります。
| パラメーター | 要件 | 目的 |
|---|---|---|
prompt | 必須の文字列、1〜71,000文字 | 商品情報、訴求点、モジュール順を指定し、写真を@image_1、@image_2で参照します |
image_urls | 必須の配列、写真1〜3枚 | 30 MB以下、各辺300 px以上、比率2:5〜5:2のJPGまたはPNGを使います |
page_length | 任意、short、medium、long、既定値はmedium | 詳細ページの長さを選びます |
resolution | 任意、1kまたは2k、既定値は1k | 長さとは別に出力の解像度を選びます |
掲載したい商品情報の量に合わせて長さを設定します。解像度は別に選び、店舗内での使用箇所を意識しながら生成画像を確認してください。
写真が伝える情報を基準に選びます
商品を明確に写し、番号付きの各画像が全体像や細部の拡大など何を伝えるか説明します。写真で見える情報と、文章で提供する仕様は区別してください。商品導入に使う視点と、詳細モジュールを補う視点を指定し、各写真をページの具体的な部分と結び付けます。
商品紹介の指示をまとめます
商品の識別情報と確認済みの事実から始めます。次に、メインビジュアル、提供する訴求点、補足の商品詳細、締めのパネルを、買い手に見せたい順に並べます。確認済みの文言がある場合は、お手入れ方法も含めてください。空のセクションを埋めるために、寸法、素材、訴求内容をモデルに創作させないでください。
照合できる文章を用意します
見出しと各情報ブロックの文章を引用し、掲載先のセクションを添えます。情報が不明な場合は、依頼する文章に含めません。漠然とした形容詞の一覧では確認の基準が乏しくなりますが、商品機能についての具体的な記述なら返された画像と直接比較できます。事実、ビジュアル方針、モジュール順を指示書で明確にしてください。
文章量を長さに合わせます
short、medium、longを選び、その範囲に合う指示書を作ります。短いページは簡潔な商品紹介に集中させ、長い指示書では追加の提供情報に場所を割けます。各モジュールに異なる役割を与え、プロンプト送信前に重複した訴求点を除きます。解像度の変更は別の判断であり、詰め込みすぎた文章を削る作業の代わりにはなりません。
プリザーブドローズの実行で確認したこと
2026年11月18日のリクエストではローズの写真を1枚提供し、琥珀色とアイボリーの配色で、メイン写真、3つの訴求点、お手入れ方法、締めのギフトメッセージ欄を依頼しました。設定はshortと1kです。商品写真を、導入からお手入れ、贈り物へと続く流れに結び付けました。
返されたのは、提供したローズ写真を中心とする短い商品詳細ページの1024 x 5021のPNG1枚でした。買い手向けに準備する前に、流れ全体で商品の外観を確認し、訴求点、お手入れの文章、締めのメッセージを提供原稿と照合してください。
料金と公開前の確認
選択した長さと解像度について、このページに表示される現在の料金を確認します。完成した商品詳細ページはこの2つの設定で課金され、商品写真ごとに少額の入力料金も加わります。商品画像は必須でも無料の添付ではないため、入力料金を考える際は提供する全写真を含めてください。
店舗用に画像を準備する前に、描かれた商品を提供写真と比較し、すべての訴求、数値、お手入れ方法を商品情報と照合します。予定の表示サイズで余白や読む順序も確認してください。結果は1枚のページ画像なので、後からレイアウトや文章を直すには画像編集やデザインの工程が必要です。
別のシリーズが成果物に合う場合
Klingは、標準の画像ワークフローを単体のビジュアル素材向け、シリーズのワークフローを統一感のある別々の画像向けと説明しています。単体の商品画像にはKling Image 4.0、個別の画像集にはKling Image 4.0 Setを比較してください。自分の写真を基にした連続する商品詳細ページが必要なら、このエンドポイントを使います。
API クイックスタート
# Generate the idempotency key once; reuse it when retrying after a lost response.
export SPICY_IDEMPOTENCY_KEY="${SPICY_IDEMPOTENCY_KEY:-$(uuidgen)}"
curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $SPICY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $SPICY_IDEMPOTENCY_KEY" \
-d '{
"model": "kling/image-4.0-long/edit",
"input": {
"image_urls": [
"https://example.com/reference.png"
],
"page_length": "medium",
"prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette",
"resolution": "1k"
}
}'
# Copy data.taskId from the response into TASK_ID, then poll the status.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.spicyapi.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $SPICY_API_KEY"
認証、完全なスキーマ、ポーリング、エラー処理は API リファレンスを参照してください。













