
Kling Image 4.0 APIを特徴づける機能は2つあります。1つは kling-4.0-image の 8K 解像度ティアで、PoYoでこれを持つ画像モデルは唯一です。もう1つは独立したモデル kling-4.0-long-image で、Webページ全体やEC詳細ページを1枚の縦長画像としてデザインします。この記事では、リクエストボディ、リリース当日に実行した際の結果、ファイルの扱い方を紹介します。まずプレイグラウンドで試したい場合は、Kling Image 4.0のモデルページから始めてください。
Kling Image 4.0 APIによるネイティブ8K
Klingは発表記事で、Kling Image 4.0がネイティブ8K画像生成を導入したと述べています。つまり、後からアップスケールするのではなく、そのサイズで画像を生成するということです。PoYoでは1つのフィールドで指定できます。
{
"model": "kling-4.0-image",
"input": {
"prompt": "A rider on a vintage motorbike crossing a desert highway at sunrise, long shadows, dust in the air, cinematic photography",
"size": "16:9",
"resolution": "8K",
"n": 1
}
}
8Kリクエストで返されるもの
PoYoチームは2026年11月19日に、本番APIでこのリクエスト形式(テキストから画像、size: "16:9"、resolution: "8K"、n: 1)を実行しました。
| 結果 | 値 |
|---|---|
| 出力 | 10880×6144 PNG |
| ファイルサイズ | 約128 MB |
| 費用 | 32クレジット($0.16) |
| 送信から結果取得まで | 約3.8分 |
| ピクセル形式 | 不透明な画像でもRGBA(アルファチャンネル付きPNG) |
参考までに、PoYoのドキュメントでは1:1のサイズを2Kで2048×2048、8Kで8192×8192、4Kの16:9を5440×3072としており、一般的なPNGのサイズは2K、4K、8Kでそれぞれ約7.5 MB、27 MB、100 MBです。同じセッションで生成した2Kの16:9画像は2720×1536でした。
解像度ティアの比較
resolution | サイズの例 | 1枚あたりの料金 | 用途 |
|---|---|---|---|
2K | 2048×2048(1:1)、2720×1536(16:9、実測) | 13クレジット($0.065) | Web、SNS、ラフ |
4K | 5440×3072(16:9) | 19クレジット($0.095) | 大型スクリーン、適度なトリミング |
8K | 8192×8192(1:1)、10880×6144(16:9、実測) | 32クレジット($0.16) | 印刷物、ビルボード、1フレームからの大胆なトリミング |
参照は1つにつき1クレジットで、1リクエストにつき1回加算されます。
パイプラインでの8Kファイルの扱い
8KのPNGは、サムネイルのように扱うには大きすぎます。実践的な変更点は次のとおりです。
callback_urlを使う。 数分かかるリクエストのために、Webリクエストを開いたままにすべきではありません。タスクが完了または失敗すると、PoYoがタスクの結果を指定したURLにPOSTします。- ダウンロードはディスクやオブジェクトストレージにストリーミングする。 メモリ上限の小さいサーバーレス関数で128 MBのボディをメモリに読み込まないでください。また、HTTPクライアントの読み取りタイムアウトを延ばしてください。
- 不要ならアルファチャンネルを削除する。 不透明な画像でも、ダウンロードしたファイルはRGBAでした。配信用にRGB、あるいはJPEGやWebPへ変換する処理は自分で追加する必要があります。APIには出力形式のフィールドがありません。
- 8Kのマスターを保管し、派生ファイルを配信する。 8Kで1回生成し、Web用にリサイズします。同じプロンプトで8Kを再生成すると、別の画像になり、改めて課金されます。
- セットの予算は慎重に。
nは1枚あたりの料金に掛け算されます。8Kで10枚のセットは320クレジット($1.60)です。PoYoのドキュメントでは8Kの10枚シリーズに約30分かかるとされているので、Webhookを使うべき領域です。
既存の画像を8Kにアップスケールする
image_urls に画像を渡し、resolution を 8K に設定して、変えてはいけない部分を指定します。
{
"model": "kling-4.0-image",
"input": {
"prompt": "Recreate @Image1 at full detail. Keep the composition, subject, colors and lighting of @Image1 unchanged.",
"image_urls": ["https://example.com/product-hero.png"],
"resolution": "8K"
}
}
これはピクセル単位のアップスケーラーではなく、参照をもとにした新たな生成です。そのため、まったく同じに保つ必要がある要素はすべて記述してください。費用は32 + 1 = 33クレジット($0.165)です。
kling-4.0-long-imageによるロングページ
Klingは、EC商品詳細ページやWebデザイン向けの縦長生成について、完成したレイアウトを1枚の画像で提供すると説明しています。PoYoでは、skill フィールドを持つ独立したモデルIDとして提供しています。出力はPNG 1枚で、幅は 1K で1024 px、2K で2048 px、高さは内容に応じて決まります。
Webページデザイン
{
"model": "kling-4.0-long-image",
"input": {
"prompt": "A landing page for a specialty coffee roastery: hero with coffee beans, story section, three featured blends with prices, brewing guide, customer reviews and footer. Warm earthy palette. All text on the page is in English.",
"skill": "webpage",
"resolution": "1K"
}
}
webpage の任意入力:
| フィールド | プロンプトのタグ | 効果 |
|---|---|---|
style_image_url | @StyleImage | デザインがその画像のビジュアルとレイアウトのスタイルに従う |
subject_image_url | @SubjectImage | その画像に写っている被写体を中心にデザインを構成する |
計測結果: 1K の webpage リクエストで1024×4257のページが1枚返され、費用は110クレジット($0.55)、約1.7〜2.2分かかりました(PoYo本番API、2026年11月19日)。
ページ内テキストの言語を指定する
これは、すべてのロング画像プロンプトに追加すべき唯一の項目です。テストでは、最初のWebページリクエストでページ内テキストの言語を指定しない英語のプロンプトを使ったところ、中国語のテキストのページが返ってきました。プロンプトに「All text on the page is in English.」という一文を追加すると、次の実行で解消しました。再実行のたびに全額がかかる(1KのWebページで110クレジット)ため、ページに必要な言語が何であれ、最初からプロンプトテンプレートに言語の指定を入れておきましょう。Klingはテキスト描画の対応言語として、英語、簡体字中国語、繁体字中国語、日本語、韓国語、スペイン語、ポルトガル語を挙げています。
EC詳細ページ
skill: "ecommerce" は、1〜3枚の商品写真から商品詳細ページを作成します。写真は @Image1 〜 @Image3 として参照します。
{
"model": "kling-4.0-long-image",
"input": {
"prompt": "Design a product detail page for the insulated water bottle in @Image1: hero shot, key features, capacity and size, materials, and lifestyle scenes. All text on the page is in English.",
"skill": "ecommerce",
"image_urls": ["https://example.com/water-bottle.png"],
"length": "medium",
"resolution": "1K"
}
}
length はページのセクション数と料金を決めます。
length | セクション数(目安) | 1K | 2K |
|---|---|---|---|
short | 2〜5 | 47クレジット($0.235) | 57クレジット($0.285) |
medium(デフォルト) | 6〜10 | 94クレジット($0.47) | 110クレジット($0.55) |
long | 11〜18 | 157クレジット($0.785) | 173クレジット($0.865) |
商品写真1枚ごとに1クレジットが加わります。PoYoのドキュメントでは、どれほど縦長になるかの例として 2K の long ページを挙げており、最大2048×54,941 px、約87 MBです。
ロング画像の表示と分割
幅1024 px、高さ数千ピクセルのページは、通常の画像プレビューには収まりません。レビュー用にはセクションごとや画面の高さごとのタイルに分割し、ダウンロード用にオリジナルを保管してください。結果はデザインカンプとして扱いましょう。テキスト、価格、ボタンはHTMLではなくピクセルです。
8Kとロングページのプロンプトチェックリスト
- 画像内のテキストがあれば、その言語を明記する。
- ページでは、ヒーロー、機能、仕様、レビュー、フッターのようにセクションを順番に列挙する。
- 正確なコピーは引用符で囲み、配置場所を指定する。Klingによれば、モデルは1枚の画像に最大2,000文字を描画できる。
- 8Kでは、トリミングしても残したい質感や細部を記述する。
- 参照では、各タグに役割を与える:「
@Image1は商品。形とラベルを保つ」。
リクエストの完全なリファレンスとポーリングのコード:Kling Image 4.0 APIガイド。費用:Kling Image 4.0 APIの料金。2つのモデルIDの背景:Kling Image 4.0とは。
よくある質問
Kling Image 4.0 APIは本当に8Kで出力しますか?
はい。resolution: "8K" を指定した16:9のテストでは10880×6144のPNGが返され、PoYoのドキュメントでは1:1で8192×8192とされています。Klingはこれをネイティブ8K生成と説明しています。
Kling Image 4.0 APIの8Kリクエストにはどのくらい時間がかかりますか?
リリース当日のテストでは、16:9の8K画像1枚で約3.8分でした。大きなセットはさらに大幅に時間がかかるため、callback_url を使ってください。
Kling Image 4.0 APIで8K画像を生成する費用はいくらですか? PoYoでは1枚あたり32クレジット($0.16)で、参照1つにつき1クレジットが加わります。
Kling Image 4.0のロング画像APIはどのサイズを返しますか?
幅は 1K で1024 px、2K で2048 pxで、高さは内容に応じて決まります。私たちの1K Webページは1024×4257でした。
Kling Image 4.0のロングページのテキストが違う言語になるのはなぜですか? プロンプトで言語を指定していないためです。「All text on the page is in English.」のような一文を追加してください。