はじめに
連作全体の指示を 1 つ書くと、画像が順番どおりに返ります。人物、衣服、商品を全編に登場させたい場合は、最大 10 枚の参照画像を追加できます。
| 項目 | 値 |
|---|---|
| 入力 | テキスト |
| 出力 | 画像 |
| 公開元 | Kling |
| 公開日 | 2026年11月17日 |
| リクエストあたりの画像数 | 2〜10枚、デフォルト4枚 |
| プロンプトの長さ | 1〜21,000文字 |
| 解像度の選択肢 | 2k(デフォルト)、4k、8k |
| 出力アスペクト比 | デフォルトはauto。16:9、9:16、1:1、4:3、3:4、3:2、2:3、21:9にも対応します。 |
| 共有参照画像 | 任意、10枚まで |
| 参照画像の形式 | JPGまたはPNG |
| 参照ファイルのサイズ | 1枚あたり30 MBまで |
| 参照画像の寸法 | 各辺300 px以上 |
| 参照画像のアスペクト比 | 2:5〜5:2 |
| 課金基準 | 選択した解像度で納品された画像ごとの料金に、参照画像ごとの入力料金を加算します。 |
主な機能とハイライト
同じ棚のバラを2つの照明で比較します
2枚の画像を求めたリクエストでは、製品参照を1枚使い、製品を同一に保つよう指示しました。朝の出力には、夕方の画像と同じ木製の棚に同じバラが写っています。どちらも2k設定で返された2048 × 2048のPNGでした。
暖かなランプの光が場面を変えます
対になる出力では、バラと木製の棚が暖かなテーブルランプに照らされています。淡い朝の光の画像と同じリクエストから生成され、出力は2枚、画面は正方形です。ペアを比較し、維持された被写体や棚と、指定した照明の変化を確認してください。
各フレームに明確な役割を与えます
共通の要件を一度記載し、その後に各画像を順番に説明します。リクエストでは2〜10枚の出力、10枚までの共有参照画像、2k・4k・8kの解像度を指定できます。枚数、形状、解像度はそれぞれ別に決め、確認したいシリーズに合わせて設定します。
リクエストパラメーター
| パラメーター | 必須 | 説明 |
|---|---|---|
prompt | はい | 必須で、21,000 文字まで入力できます。連作全体のルールを書いてから、各画像を順番に説明します。 1 文字以上 · 21000 文字以内 |
reference_image_urls | いいえ | 任意で、連作全体に共有する画像を 10 枚まで指定できます。使用できるのは JPG または PNG で、30 MB 以下、各辺 300 px 以上、縦横比 2:5 から 5:2 のファイルです。 10 件以内 |
num_outputs | いいえ | 連作の枚数で、2〜10 枚を指定できます。既定は 4 枚で、納品された画像ごとに課金されます。 |
resolution | いいえ | 連作の解像度で、2k、4k、8k から選びます。既定は 2k で、解像度を上げるとすべての画像の料金が上がります。 |
aspect_ratio | いいえ | 連作全体の形で、auto、16:9、9:16、1:1、4:3、3:4、3:2、2:3、21:9 から選びます。既定は auto で、この選択は料金に影響しません。 |
料金
連作として納品された画像 1 枚ごとに、選択した解像度の料金が発生します。連作で共有する参照画像にも、1 枚につき少額の入力料金がかかります。
| 仕様 | 料金 |
|---|---|
| $0.063 / 枚 |
| $0.094 / 枚 |
| $0.157 / 枚 |
ユースケース
製品の照明比較
製品とその配置を固定するよう指示し、照明条件を変えて比較します。バラのリクエストでは、同じ棚の場面について、朝の光と夕方のランプの光による画像が返されました。
工芸作業の工程ボード
工房での作業を番号付きの工程として説明し、num_outputsを予定する順序の枚数に合わせます。工程全体で引き継ぐ道具、素材、作業場所の細部を明記してください。
カタログ用アングルの計画
共通の参照画像と維持する細部の一覧を用意し、各画像に異なる製品アングルを割り当てます。カタログ素材を選ぶ前に、返された製品を参照画像と照合します。
キャンペーンの構図検討
共通の被写体と配色を用い、各画像には異なる構図を指定します。掲載先に合う対応アスペクト比を選び、全体の視覚的な連続性を確認します。
プロンプトガイドと実践のヒント
共通の被写体を定義します
シリーズをつなぐ製品、場所、職業をテーマにした被写体を説明します。個々の画像を列挙する前に、維持したい細部を指定してください。
各画像の目的を決めます
必要な順に画像に番号を付け、1枚につき1つの視点や瞬間を説明します。num_outputsを、その枚数に合わせて2〜10に設定します。
参照画像を対応付け、画面を設定します
視覚的な基準が必要な場合は共通の参照画像を追加し、@image_1や@image_2で指定します。シリーズの解像度とアスペクト比も選択します。
一連の画像をまとめて確認します
返されたすべての画像で、被写体の細部と構図を比較します。バラの例では2枚による照明の比較を確認できるため、自分の指示を書く前の参考にできます。
共通の被写体を中心にシーケンスを組み立てます
Kling Image 4.0 Setエンドポイントは、関連する2〜10枚の画像を作る指示を受け付けます。シリーズ全体を説明したうえで、各画像の順序と視覚的な目的を指定します。任意の参照画像はリクエスト全体に適用されるため、製品写真を照明比較や複数アングルの基準として使えます。
計画時に整理するのは連続性です。見分けられる状態で維持する細部と、変化させる細部を決めてください。照明比較では製品と配置を固定する要素として明記し、各画像に異なる光源を割り当てます。工程のシーケンスでは作業場所を一度定義し、各段階の作業を説明します。
リクエストパラメータ
以下はこのエンドポイントの公開フィールドです。指定する画像数を、プロンプト内の番号付き説明と一致させてください。
| フィールド | 必須 | 選択肢と制限 | 役割 |
|---|---|---|---|
prompt | はい | 1〜21,000文字 | シリーズ、順番に並べた画像、維持する細部を説明し、参照画像を@image_1、@image_2で指定します |
reference_image_urls | いいえ | JPGまたはPNGを10ファイルまで | 共通の視覚的参照です。各ファイルは30 MB以下、各辺300 px以上、アスペクト比2:5〜5:2が必要です |
num_outputs | いいえ | 2〜10、デフォルト4 | リクエストする関連画像の枚数です |
resolution | いいえ | 2k、4k、8k、デフォルト2k | 画像料金を決める解像度の区分です |
aspect_ratio | いいえ | auto、16:9、9:16、1:1、4:3、3:4、3:2、2:3、21:9、デフォルトauto | シリーズの形状です。autoはプロンプトと参照画像から選択します |
出力画像と参照画像は別々に数えます
参照画像は視覚的な入力を与えるもので、シリーズの出力枚数を設定するものではありません。バラのリクエストでは、参照画像を1枚使い、num_outputsを2に設定しました。アップロード数で出力枚数が決まると考えず、必要な枚数を意図して指定してください。
納品されるシリーズの予算を確認します
選択した解像度について、このページに表示される料金を使います。納品された画像ごとにその料金が適用され、参照画像ごとに少額の入力料金が加算されます。シリーズは1枚の画像としてではなく、納品画像と参照入力の合計で課金されます。リクエストを送信する前に、出力枚数、解像度、参照画像数をまとめて確認してください。
固定する細部と変更点を指示に書き分けます
共通の被写体、場所、視覚的な表現から書き始めます。続けて番号付きの画像説明と、維持する要素に関する明確な指示を記載します。製品の比率、棚での配置、カメラの視点、照明など、確認する人が照合できる細部にプロンプトの文章を使ってください。
各画像に1つの視覚的な役割を割り当てます
製品シリーズでは、ある画像で製品を示し、別の画像で異なる照明下の様子を確認できます。工房での作業なら、各画像を名前の付いた工程として描けます。各画像の違いを説明し、意味のある流れをリクエストに与えてください。
参照画像の役割を明示します
@image_1の製品や@image_2の場所を特定し、シリーズがそれぞれから引き継ぐ要素を説明します。番号が入力順序と一致することを確認してください。
形状と解像度を意図して選びます
シリーズでは、アスペクト比と解像度の区分を共有します。正方形のレイアウトが必要な場合は、形状をautoに任せず1:1を選択します。バラの生成では1:1と2kを指定しました。別の解像度区分が作業に適するかを決める前に、構図と維持された被写体の細部を確認してください。
バラのリクエストで返された結果
2026年11月18日、参照元の製品を木製の棚に置き、2つの照明条件で描くプロンプトを送信しました。設定は参照画像1枚、出力2枚、解像度2k、アスペクト比1:1でした。リクエストから2048 × 2048のPNGが2枚返されました。
同じ指示から朝と夕方を描きます
朝の画像には、淡い光の中で木製の棚に置かれたバラが描かれています。対になる画像では、同じ棚の同じバラが暖かなテーブルランプに照らされています。両方とも同じリクエストから返された画像です。維持する目標と指定した照明の変化を評価するときは、2枚を一緒に比較してください。
画像を選ぶ前に全体を確認します
返された画像を並べ、プロンプトに書いた共通要件と比較します。製品の検討では、予定した照明の変化に加え、製品の比率や位置を確認してください。工程ボードでは、指定した工程がすべて含まれ、作業場所の細部がシーケンスをつないでいるかを確認します。修正が必要な視点がある場合は、共通の指示を明確に保ちながら、その画像の説明を具体化します。
制限と関連する選択肢
画像数は2〜10枚、プロンプトは21,000文字以内に収める必要があります。各参照画像について、表に記載したファイル、寸法、アスペクト比の要件を確認してください。シリーズ生成でも視覚的な確認は必要です。カタログやキャンペーンに使用する前に、返されたすべての画像で製品の細部と意図した変化を比較します。
単独の画像を作る場合はKling Image 4.0を比較してください。連続したページ構成にはKling Image 4.0 Longを検討できます。Klingの説明では、長尺画像モードはページ全体を1枚の画像として生成します。別々の画像が必要か、連続したページレイアウトが必要かに合わせて選択してください。
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-set/text-to-image",
"input": {
"aspect_ratio": "auto",
"num_outputs": 4,
"prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette",
"resolution": "2k"
}
}'
# 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 リファレンスを参照してください。













