圖片擴展
透過 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>"
}