画像拡張
POST
/kling/v1/images/editing/expand
参照画像の周囲を比例拡張し、アウトペインティング結果を生成します。
Authorizations
bearer
Type
HTTP (bearer)
Request Body
application/json
image
string
Required
参照画像。
画像の Base64 エンコードまたは画像 URL(アクセス可能であること)を指定できます。
up_expansion_ratio
number
Required
上方向の拡張範囲。元画像の高さの倍数で計算します。
範囲:[0, 2]。新画像の全体面積は元画像の 3 倍を超えられません。
例:元の高さ 20、値 0.1 → 元画像上端から新画像上端まで 20 × 0.1 = 2(拡張領域)。
down_expansion_ratio
number
Required
下方向の拡張範囲。元画像の高さの倍数で計算します。
範囲:[0, 2]。新画像の全体面積は元画像の 3 倍を超えられません。
例:元の高さ 20、値 0.2 → 元画像下端から新画像下端まで 20 × 0.2 = 4(拡張領域)。
left_expansion_ratio
number
Required
左方向の拡張範囲。元画像の幅の倍数で計算します。
範囲:[0, 2]。新画像の全体面積は元画像の 3 倍を超えられません。
例:元の幅 30、値 0.3 → 元画像左端から新画像左端まで 30 × 0.3 = 9(拡張領域)。
right_expansion_ratio
number
Required
右方向の拡張範囲。元画像の幅の倍数で計算します。
範囲:[0, 2]。新画像の全体面積は元画像の 3 倍を超えられません。
例:元の幅 30、値 0.4 → 元画像右端から新画像右端まで 30 × 0.4 = 12(拡張領域)。
prompt
string
ポジティブテキストプロンプト。
2500 文字以内。
n
integer
Required
生成する画像枚数。
範囲:[1, 9]。
callback_url
string
タスク完了時のコールバック URL
external_task_id
string
外部タスク ID
Responses
OK
application/json
object
task_id
string
タスク ID
task_status
string
タスクステータス