Kling Image 4.0 長尺画像の生成
Web ページのデザインや EC の商品詳細用の長尺画像を 1K または 2K で生成
中国本土のユーザー向け: 中国本土のユーザーは https://toapis.cn を API エンドポイント(Base URL)としてご利用ください.本ドキュメント内の例では https://toapis.com を https://toapis.cn に置き換えてください.
kling-image-4.0-long は、リクエストごとに長尺画像を 1 枚、非同期で生成します。Web ページのデザインには webpage、EC の商品詳細画像には ecommerce を選びます。
Authorizations
Authorizationstringヘッダー必須All endpoints require Bearer Token authentication
Get your API Key from the API Key Management Page
Add to request header:
Authorization: Bearer YOUR_API_KEYBody
application/json で送信し、以下のフィールドはリクエスト本文の最上位に指定します。
modelstringボディ必須デフォルト: kling-image-4.0-longkling-image-4.0-long を指定します。
promptstringボディ必須生成するレイアウトと内容を、空白のみではないテキストで指定します。
skillstringボディ必須webpage は Web ページのデザインを、ecommerce は EC の商品詳細用の長尺画像を生成します。
resolutionstringボディデフォルト: 1K1K または 2K を指定します。大文字と小文字は区別しません。
nintegerボディデフォルト: 1生成枚数。1 に固定されています。省略するか、整数の 1 を指定してください。
lengthstringボディecommerce 専用です。short は約 2-5 セクション、medium (デフォルト) は約 6-10 セクション、long は約 11-18 セクションです。すべてのセクションが 1 枚の画像になります。
image_urlsstring[]ボディecommerce では、このフィールドか reference_images に商品参照画像を 1〜3 枚指定します。プロンプトの @image_1、@image_2、@image_3 は配列の順番に対応します。
reference_imagesstring[]ボディecommerce で image_urls の代わりに使えます。どちらか一方のみ指定します。
style_reference_image_urlstringボディwebpage 専用の任意項目です。デザインのスタイルの参考にする画像の URL を 1 つ指定できます。
subject_reference_image_urlstringボディwebpage 専用の任意項目です。主題の参考にする画像の URL を 1 つ指定できます。
callback_urlstringボディタスク終了時の通知先 URL です。トークンのタスク Webhookを設定している場合に指定できます。デフォルトの URL と同じスキーム、ホスト、ポートを使用してください。省略すると、トークンで有効になっているデフォルトの通知先が使われます。
参照画像には、サービスがアクセスできる HTTP(S) URL を使用します。ローカルファイルは画像アップロード API で URL を取得できます。
パラメータの制限
webpage では length、image_urls、reference_images を省略してください。空の配列や null も指定できません。スタイルと主題の参照画像を両方省略すると、テキストだけで生成します。ecommerce では style_reference_image_url と subject_reference_image_url を省略してください。
size、aspect_ratio、ratio、series_amount、result_type、contents、options、settings は省略してください。
タスクの照会
返された id と送信時と同じ API キーを使って、画像タスクを照会します。queued と in_progress は処理中です。completed では result.data[0].url から画像の URL を取得でき、failed では error でエラーの内容を確認できます。
curl "https://toapis.com/v1/images/generations/TASK_ID" \
-H "Authorization: Bearer $TOAPIS_API_KEY"課金
基本料金はリクエスト単位で、課金リージョン、skill、resolution によって異なります。ecommerce では length も料金に影響します。同じ API キーで GET /v1/pricing?model=kling-image-4.0-long を照会します。中国本土向けの料金カタログには ®ion=cn、国際向けの料金カタログには ®ion=global を追加します。API ドメインにかかわらず、リージョンを省略すると global が使われます。
該当する料金項目に input_image_unit_price が含まれる場合、free_input_image_count を超えた分の参照画像に 1 枚ずつ追加料金がかかります。確定した請求額はタスクの billing に表示されます。詳しくは実際の費用とタスク使用量を参照してください。
Response
idstringUnique task identifier for status queries
objectstringObject type, always generation.task
modelstringモデル name used
statusstringリクエストの受理時は queued です。
progressintegerTask progress percentage (0-100)
created_atintegerTask creation timestamp (Unix timestamp)
metadataobjectTask metadata
result.data[].urlstringタスク完了時に返る 1 枚の画像の URL。
実行前に環境変数 TOAPIS_API_KEY を設定してください. 参照画像の例にある example.com はプレースホルダーです. アクセス可能な画像 URL に置き換えてください.
リクエスト例
curl --request POST \
--url https://toapis.com/v1/images/generations \
--header "Authorization: Bearer $TOAPIS_API_KEY" \
--header "Content-Type: application/json" \
--data '{
"model": "kling-image-4.0-long",
"prompt": "陶芸工房の縦長のランディングページをデザインしてください。スタイル参照画像の雰囲気を取り入れ、主題参照画像の手作りマグカップをメインにしてください。教室の日程表と予約欄を入れてください。",
"skill": "webpage",
"n": 1,
"resolution": "1K",
"style_reference_image_url": "https://example.com/pottery-style.png",
"subject_reference_image_url": "https://example.com/handmade-mug.png"
}'curl --request POST \
--url https://toapis.com/v1/images/generations \
--header "Authorization: Bearer $TOAPIS_API_KEY" \
--header "Content-Type: application/json" \
--data '{
"model": "kling-image-4.0-long",
"prompt": "@image_1 のデスクライトの商品詳細を縦長の画像にしてください。操作ボタンの拡大写真に @image_2 を使い、明るさの設定、製品寸法、同梱物を紹介してください。",
"skill": "ecommerce",
"n": 1,
"resolution": "2K",
"length": "medium",
"image_urls": [
"https://example.com/desk-lamp.png",
"https://example.com/lamp-controls.png"
]
}'レスポンス例
{
"id": "tsk_img_example",
"object": "generation.task",
"model": "kling-image-4.0-long",
"status": "queued",
"progress": 0,
"created_at": 1794960000,
"metadata": {}
}{
"id": "tsk_img_example",
"object": "generation.task",
"model": "kling-image-4.0-long",
"status": "completed",
"progress": 100,
"created_at": 1794960000,
"metadata": {},
"result": {
"type": "image",
"data": [
{
"url": "https://example.com/generated/kling-image-4.0-long.png"
}
]
}
}