Kling Image 4.0 画像生成
Kling Image 4.0 で 2K、4K、8K の画像を生成・編集
中国本土のユーザー向け: 中国本土のユーザーは 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_KEYBody
application/json で送信し、以下のフィールドはリクエスト本文の最上位に指定します。
modelstringボディ必須デフォルト: kling-image-4.0kling-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
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",
"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"
}
]
}
}