はじめに
1〜10 枚の画像をアップロードし、指示の中で番号を使って呼び、変更内容を説明します。写真のスタイル変更、被写体の移動、人物と衣装と商品の組み合わせに使えます。
| 項目 | 値 |
|---|---|
| 入力 | 画像 |
| 出力 | 画像 |
| 公開元 | Kling |
| 公開日 | 2026年11月17日 |
| タスク | テキストからの画像生成、画像編集 |
| プロンプトの長さ | 1〜21,000文字 |
| 解像度 | 2k(既定)、4k、8k |
| 独立した出力 | 1リクエストあたり1〜9枚、既定は1枚 |
| 出力比率 | auto(既定)、16:9、9:16、1:1、4:3、3:4、3:2、2:3、21:9 |
| 編集用参照画像 | アップロード順に参照する1〜10枚 |
| 参照画像の形式 | JPGまたはPNG |
| 参照ファイルのサイズ | 1枚あたり30 MBまで |
| 参照画像の寸法 | 各辺300 px以上、比率2:5〜5:2 |
| 課金基準 | 出力画像ごとに解像度に応じて課金、編集では参照画像ごとの入力料金も加算されます |
主な機能とハイライト
正確な見出しと追加文
SLOW STEEPではクリーム色の紙に彫版風の藍色のティーポットと指定の見出しが描かれ、補助文も加わりました。この2kの結果は、入れる文字と追加文の範囲を定める必要性を示します。
4kの船と夜明けの霧
木造漁船、霧、淡い金色の光を指定した港の生成では、横長の情景の5440 x 3072 PNGが返されました。編集用画像の制作前に船と柔らかな光を確認できます。
8192ピクセルのシダ植物画
生成りの紙に細いインク線と落ち着いた緑の水彩を描いた8192 x 8192 PNGが返されました。作例で正方形の構図と輪郭線と水彩の組み合わせを確認できます。
琥珀色の背景のバラ
参照元のバラを識別できる状態で手描きヴィンテージ広告に変更しました。未指定のROSEとNATURAL ESSENCEも加わったため、被写体の保持と同様に文字も確認します。
リクエストパラメーター
| パラメーター | 必須 | 説明 |
|---|---|---|
prompt | はい | 必須で、21,000 文字まで入力できます。アップロードした画像を @ |
image_urls | はい | 参照画像を 1〜10 枚指定します。番号はアップロード順です。 1 件以上 · 10 件以内 |
num_outputs | いいえ | 返す結果の枚数で、1〜9 枚を指定できます。既定は 1 枚で、納品された画像ごとに課金されます。 |
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 / 枚 |
ユースケース
茶祭りのポスター
イベント名を引用符で指定し、紙の色と中央の絵を伝えます。2kのSLOW STEEPでは藍色のティーポットの上に正しいタイトルが描かれましたが、補助文も加わったため納品前の校正が必要です。
編集用の港の情景
物体と光で場所を描写し、掲載先に合う横長の構図を選びます。4kの港では木造漁船、霧、淡い夜明けの光を描いた5440 x 3072 PNGが返されました。
大きなレイアウトの植物画
植物、紙、線、配色を指定して解像度を選びます。正方形の8kシダ植物画は、生成りの紙にインクと落ち着いた緑の水彩を描いた8192 x 8192 PNGでした。
参照画像から広告案を作る
商品画像を編集に渡し、新しい表現を指定します。バラは琥珀色の背景でも識別できましたが、追加されたROSEとNATURAL ESSENCEの確認が必要でした。
プロンプトガイドと実践のヒント
素材を選ぶ
文章で情景を伝える場合はテキストからの画像生成、既存画像から被写体や表現を引き継ぐ場合は画像編集を使います。
情景と変更を伝える
被写体、場所、照明、正確な文言を指定します。編集ではアップロード順に@
image_1、@image_2と参照し、変更点と残す部分を伝えます。構図と枚数を決める
2k、4k、8kと対応する比率を選ぶかautoにします。独立した画像を1〜9枚指定し、解像度と参照入力に応じた表示価格を確認します。
文字と細部を確認する
文字を原稿と、編集対象を参照画像と照合します。茶祭りのポスターとバラの広告では未指定の文字が加わりました。厳密な構図では「ほかの文字を入れない」と指示し、結果を校正します。
変更点を定めて画像を編集する
次のデザインで元の被写体や表現を使う場合は既存画像を渡します。Kling Image 4.0の画像編集はプロンプトと1〜10枚の参照画像を受け付けます。各画像の役割、変更点、識別できる状態で残す細部を伝えます。
バラの編集では琥珀色の背景の手描きヴィンテージ広告に変えました。バラは識別できましたが、不要な文字も加わりました。納品画像を選ぶ前に被写体と全体を確認します。
参照画像と設定を準備する
番号を記述する前に形式とアップロード順を確認します。各画像を役割と対応させ、番号と指示を一致させます。
パラメーター一覧
プロンプトと参照画像は必須です。出力枚数、解像度、比率は任意で、以下の既定値を使います。
| パラメーター | 入力 | 既定値 | 使い方 |
|---|---|---|---|
prompt | 必須の文字列、1〜21,000文字 | なし | 参照画像を指定し、変更点と保持する部分を分ける |
image_urls | 必須の配列、1〜10枚 | なし | 指示で参照する順にJPGまたはPNGを渡す |
num_outputs | 1〜9の整数 | 1 | 独立した編集結果を生成 |
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 | 比率を固定するか指示と参照画像に委ねる |
各参照画像は30 MBまで、各辺300 px以上、比率2:5〜5:2が条件です。これは入力画像の要件です。出力の構図は別に指定し、元画像の寸法で決まるとは考えません。
素材の役割を指示する
仕上がりを説明する前に各画像の役割を明確にします。たとえば@image_1から陶器、@image_2から配色を使います。続けて背景と表現を記述し、保持する細部と変更点を分けます。
入力順と番号を合わせる
参照配列の先頭を@image_1、次を@image_2とし、順に続けます。被写体、配色、表現などの役割を添えます。変更が元画像の細部と矛盾する場合は、変える部分を明確にします。
保持する部分を具体的に伝える
水差しの取っ手の形、花の輪郭、商品の模様などを挙げます。その後に絵画風の質感、別の背景色、新しい配置を指定します。出力は元画像と照合してください。保持の指示は比較確認の代わりにはなりません。
スタイル変更でも文字を管理する
「ヴィンテージ広告」はジャンルを示しますが、モデルが文言を作る余地も残します。入れる文字を正確に指定するか、不要なら文字を入れないよう伝えます。「ほかの文字を入れない」と範囲を定め、結果を確認します。バラの編集は表現を変える場合にも文字の確認が必要なことを示します。
確認結果:琥珀色の背景のバラ
amber-rose-vintage-adでは参照画像を使い、2k、2:3、出力1枚を指定しました。1664 x 2496 PNGが1枚返されました。バラは識別できる状態で琥珀色の背景に描き直され、指定した手描きの方向性を反映しました。
指示せずに現れた文字
同じ出力にROSEとNATURAL ESSENCEが入りました。どちらも指示にはありません。被写体が保持されても、広告の納品前に確認すべき不具合として扱います。周囲の小さな行も含め、すべての文字を原稿と照合します。
素材を増やす前に料金を把握する
選んだ解像度の表示価格を確認します。出力画像ごとに課金され、参照画像ごとに少額の入力料金も加わります。編集内容に合う素材リストを用意し、各画像の役割と入力料金を判断します。独立した出力を増やすと確認する画像も増えます。
成果物に合う方法を選ぶ
元画像が不要ならテキストからの画像生成を使います。入力が被写体や表現を提供する場合は画像編集を使います。修正では対象の細部を特定し、残す特徴と変更をあわせて伝えます。採用前に各結果を元画像と比較します。
Klingによるとシリーズ生成は関連画像を計画し、長画像生成は商品詳細やウェブページの画像全体を作ります。統一した画像集にはKling Image 4.0 Set(kling/image-4.0-set)、長いページにはKling Image 4.0 Long(kling/image-4.0-long)を選びます。ここでの1〜9枚の独立した編集を統一シリーズとして扱わないでください。他モデルとの比較では素材と指示を揃え、被写体の保持、背景の変更、追加文字をまとめて確認します。
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/edit",
"input": {
"aspect_ratio": "auto",
"image_urls": [
"https://example.com/reference.png"
],
"num_outputs": 1,
"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 リファレンスを参照してください。















