图像扩展
通过 CometAPI 使用 Kling 图像扩展 API，在保留上下文的同时将图像扩展到原始边界之外，并可控地填充以生成适用于视频的素材。
curl --request POST \
--url https://api.cometapi.com/kling/v1/images/editing/expand \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"image": "https://cdn.britannica.com/70/234870-050-D4D024BB/Orange-colored-cat-yawns-displaying-teeth.jpg",
"up_expansion_ratio": 0.1,
"right_expansion_ratio": 0.1,
"left_expansion_ratio": 0.1,
"bottom_expansion_ratio": 0.1
}
'{
"code": 123,
"message": "<string>",
"data": {
"task_id": "<string>",
"task_status": "<string>",
"created_at": 123,
"updated_at": 123
},
"request_id": "<string>"
}扩展比例的工作方式
- 每个比例都相对于原始宽度或高度进行计算
- 扩展后的画布总面积仍必须保持在 Kling 文档说明的面积限制内
- 在尝试更大扩展之前，先从每侧使用
0.1这样的小值开始
当前包装器状态
- 文档中的路由为
POST /kling/v1/images/editing/expand - 在 2026-03-13 的实时验证中，最小请求返回了
{"code": null, "message": "404"} - 在再次验证之前，应将此端点视为已有文档说明，但当前在 CometAPI 包装器中不可用
授权
Bearer token authentication. Use your CometAPI key.
请求头
Optional content type header.
请求体
Source image to expand. Accepts an image URL or raw Base64 string (no data: prefix). Supported formats: JPG, JPEG, PNG. Max 10 MB, minimum 300×300 px, aspect ratio between 1:2.5 and 2.5:1.
Upward expansion as a multiple of the original image height. Range: 0–2. The resulting image area must not exceed 3× the original.
Rightward expansion as a multiple of the original image width. Range: 0–2. The resulting image area must not exceed 3× the original.
Leftward expansion as a multiple of the original image width. Range: 0–2. The resulting image area must not exceed 3× the original.
Downward expansion as a multiple of the original image height. Range: 0–2. The resulting image area must not exceed 3× the original.
Optional text prompt to guide the expanded area content. Max 2500 characters.
Number of expanded images to generate.
Webhook URL for task status notifications. The server sends a callback when the task status changes.
Optional user-defined task ID for your own tracking. Does not replace the system-generated task ID. Must be unique per account.
curl --request POST \
--url https://api.cometapi.com/kling/v1/images/editing/expand \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"image": "https://cdn.britannica.com/70/234870-050-D4D024BB/Orange-colored-cat-yawns-displaying-teeth.jpg",
"up_expansion_ratio": 0.1,
"right_expansion_ratio": 0.1,
"left_expansion_ratio": 0.1,
"bottom_expansion_ratio": 0.1
}
'{
"code": 123,
"message": "<string>",
"data": {
"task_id": "<string>",
"task_status": "<string>",
"created_at": 123,
"updated_at": 123
},
"request_id": "<string>"
}