はじめに
情景、ポスター、キャラクターを文章で説明すると、完成した静止画が返ります。解像度、画面の形、1 回に生成する枚数を選べます。
| 項目 | 値 |
|---|---|
| 入力 | テキスト |
| 出力 | 画像 |
| 公開元 | 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 文字まで入力できます。被写体、動作、場所、カメラ、光を書き、画像に描く文字は引用符で囲んでください。 1 文字以上 · 21000 文字以内 |
num_outputs | いいえ | 独立して生成する枚数で、1〜9 枚を指定できます。既定は 1 枚で、納品された画像ごとに課金されます。 |
resolution | いいえ | 出力解像度で、2k、4k、8k から選びます。既定は 2k で、高い解像度ほど 1 枚あたりの料金が上がります。 |
aspect_ratio | いいえ | 画面の形で、auto、16:9、9:16、1:1、4:3、3:4、3:2、2:3、21:9 から選びます。既定の auto はモデルに判断を任せます。 |
料金
納品された画像 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はプロンプトを必須とし、2k、4k、8kで1リクエストあたり1〜9枚の独立した画像を生成します。今回の例は茶祭りのポスター、夜明けの港、インクと水彩のシダです。
同じ指示から独立した案を生成します。確認できる枚数を選び、統一した画像集には関連するSetモデル群を使います。
リクエストの設定
プロンプトは必須です。それ以外は枚数、解像度、構図の設定で、省略すると以下の既定値になります。
| パラメーター | 入力 | 既定値 | 役割 |
|---|---|---|---|
prompt | 必須の文字列、1〜21,000文字 | なし | 被写体、場所、光、正確な文言を指定 |
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 | 固定比率か指示に応じた構図を選択 |
納品用途に合う解像度と掲載位置に合う比率を選びます。レイアウトへ配置する際は返されたファイルの寸法を確認します。以下には実際の出力サイズを示します。
描く構図を伝える
被写体と場所から始め、光と表現を指定します。港では木造漁船、夜明けの霧、淡い金色の光を挙げました。シダでは植物、生成りの紙、細いインク線、落ち着いた緑の水彩を指定しました。漠然と画質を褒める言葉より、見えるものを伝えます。
文字の指示を分ける
ポスターではタイトルを引用符で囲み、画面内の位置を指定します。必要な文言とイラストの方向性を分け、追加文が困るなら「ほかの文字を入れない」と添えます。未指定の小さな文字も含め、画像全体を校正します。
Klingによると画像内には2,000文字まで生成できます。プロンプトの21,000文字制限とは別です。前者は描く文字、後者は説明全体を指します。タイトルと補助文を配置位置ごとにまとめると、指示が読み取りやすくなります。
情景と構図を合わせる
掲載先が決まっていれば固定比率を選びます。縦長ポスターと横長の編集用画像では構図が異なります。指示に形を委ねるならautoを使います。試作後に解像度を変えたら、前の構図や文字がそのまま残ると考えず、新しい画像を再確認します。
11月18日の生成結果
3回の生成では被写体、解像度、構図を変えました。作例の構図、表面の表現、文字を制作時の参考にします。
2kの茶祭りポスター
SLOW STEEPは3:4で1760 x 2336 PNGが1枚返されました。クリーム色の紙の藍色の彫版風ティーポットの上に正しいタイトルがありました。補助文も生成されたため、使用前に見出しと補助文を確認します。
4kの港
16:9で5440 x 3072 PNGが1枚返され、木造船、霧、淡い夜明けの光が描かれました。横長の構図に船、霧、周囲の港が収まっています。
8kのシダ
正方形の植物画では、生成りの紙にインクと水彩でシダを描いた8192 x 8192 PNGが1枚返されました。Klingは8kをネイティブ生成と説明しています。作例で細い線、配色、正方形の構図を確認します。
料金と確認の判断
選んだ解像度の表示価格を確認します。出力画像ごとに課金され、独立した出力を増やすと課金と確認の対象も増えます。比率は料金に影響しません。別の解像度や追加生成を検討する前に、選んだ解像度でレイアウトを確認します。
対応範囲と関連モデル群
このエンドポイントは元画像ではなく文章を受け付けます。既存の物体や写真を結果に反映する場合は、このページの画像編集を使います。
Klingによるとシリーズ生成は関連する画像を統一し、長画像生成は商品詳細やウェブページ向けの画像を作ります。統一した画像集にはKling Image 4.0 Set(kling/image-4.0-set)、ページ形状の成果物にはKling Image 4.0 Long(kling/image-4.0-long)を選びます。ここでの独立した静止画とは出力構造が異なります。候補は構図、正確な文言、納品条件を揃え、使用サイズで比較します。
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/text-to-image",
"input": {
"prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette",
"resolution": "2k",
"num_outputs": 1,
"aspect_ratio": "auto"
}
}'
# 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 リファレンスを参照してください。















