ToAPIsToAPIs
Kling Image 4.0

Kling Image 4.0 長尺画像の生成

Web ページのデザインや EC の商品詳細用の長尺画像を 1K または 2K で生成

POST
/v1/images/generations

中国本土のユーザー向け: 中国本土のユーザーは 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_KEY

Body

application/json で送信し、以下のフィールドはリクエスト本文の最上位に指定します。

modelstringボディ必須デフォルト: kling-image-4.0-long

kling-image-4.0-long を指定します。

promptstringボディ必須

生成するレイアウトと内容を、空白のみではないテキストで指定します。

skillstringボディ必須

webpage は Web ページのデザインを、ecommerce は EC の商品詳細用の長尺画像を生成します。

resolutionstringボディデフォルト: 1K

1K または 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 を照会します。中国本土向けの料金カタログには &region=cn、国際向けの料金カタログには &region=global を追加します。API ドメインにかかわらず、リージョンを省略すると global が使われます。

該当する料金項目に input_image_unit_price が含まれる場合、free_input_image_count を超えた分の参照画像に 1 枚ずつ追加料金がかかります。確定した請求額はタスクの billing に表示されます。詳しくは実際の費用とタスク使用量を参照してください。

Response

idstring

Unique task identifier for status queries

objectstring

Object type, always generation.task

modelstring

モデル name used

statusstring

リクエストの受理時は queued です。

progressinteger

Task progress percentage (0-100)

created_atinteger

Task creation timestamp (Unix timestamp)

metadataobject

Task 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"
      }
    ]
  }
}