ToAPIsToAPIs
Kling Image 4.0

Kling Image 4.0 画像生成

Kling Image 4.0 で 2K、4K、8K の画像を生成・編集

POST
/v1/images/generations

中国本土のユーザー向け: 中国本土のユーザーは https://toapis.cn を API エンドポイント(Base URL)としてご利用ください.本ドキュメント内の例では https://toapis.com を https://toapis.cn に置き換えてください.

kling-image-4.0 はテキストからの画像生成と、最大 10 枚の参照画像を使った編集・合成に対応します。1 回のリクエストで 2K、4K、8K のいずれかの画像を 1 枚、非同期で生成します。

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

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

promptstringボディ必須

生成する画像の内容や、参照画像に加える変更を記述します。空白以外の文字を含めてください。

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

出力解像度。2K、4K、8K が指定でき、大文字・小文字は区別しません。

aspect_ratiostringボディデフォルト: auto

出力画像のアスペクト比。auto ではモデルが比率を決めます。固定比率は次のとおりです。

16:9、9:16、1:1、4:3、3:4、3:2、2:3、21:9。

sizestringボディ

aspect_ratio の別名で、同じ値を指定できます。両方を指定する場合は値を一致させてください。

nintegerボディデフォルト: 1

生成枚数。1 に固定されています。省略するか、整数の 1 を指定してください。

image_urlsstring[]ボディ

参照画像は最大 10 枚です。配列の順に @image_1、@image_2 などを使うと、プロンプト内で各画像の役割を指定できます。各画像にはサービスが取得できる HTTP または HTTPS の URL を指定します。手元の画像は画像アップロード APIで URL を取得できます。

参照画像の形式は JPG、JPEG、PNG です。1 枚あたり 30 MB 以下で、幅と高さはともに 300 ピクセル以上、アスペクト比は 2:5 から 5:2 の範囲です。

reference_imagesstring[]ボディ

image_urls の別名です。どちらか一方を指定してください。

callback_urlstringボディ

タスク終了時の通知先 URL です。トークンのタスク Webhookを設定している場合に指定できます。デフォルトの URL と同じスキーム、ホスト、ポートを使用してください。省略すると、トークンで有効になっているデフォルトの通知先が使われます。

パラメータの制限

このエンドポイントは標準画像を 1 枚生成します。Kling 固有のフィールド contents、options、settings、result_type、series_amount は省略してください。

タスクの照会

返された 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"

課金

リクエスト単位で課金されます。料金はアカウントの料金適用地域と解像度によって異なります。アスペクト比と参照画像の枚数は料金に影響しません。実際の料金とタスクの使用量を参照してください。

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",
  "prompt": "岩の多い海岸に立つ赤と白の灯台。海霧が晴れ、朝の光が波しぶきを照らす。",
  "resolution": "2K",
  "aspect_ratio": "16:9"
}'
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",
  "prompt": "@image_1 のデスクライトを @image_2 の書斎に置いてください。ライトの形と素材感を保ち、部屋の光と影になじませてください。",
  "resolution": "4K",
  "aspect_ratio": "4:3",
  "image_urls": [
    "https://example.com/lamp.png",
    "https://example.com/study.jpg"
  ]
}'

レスポンス例

{
  "id": "tsk_img_example",
  "object": "generation.task",
  "model": "kling-image-4.0",
  "status": "queued",
  "progress": 0,
  "created_at": 1794960000,
  "metadata": {}
}
{
  "id": "tsk_img_example",
  "object": "generation.task",
  "model": "kling-image-4.0",
  "status": "completed",
  "progress": 100,
  "created_at": 1794960000,
  "result": {
    "type": "image",
    "data": [
      {
        "url": "https://example.com/generated/kling-image-4.0.png"
      }
    ]
  }
}