影像編輯
透過 CometAPI 使用 Bria Image Editing API，以 POST /bria/image/edit/ 執行 erase、gen_fill、expand、enhance、upscale 或 replace backgrounds。
curl --request POST \
--url https://api.cometapi.com/bria/image/edit/{action} \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"image": "https://raw.githubusercontent.com/cometapi-dev/.github/refs/heads/main/assets/img/original_image.png",
"mask": "https://raw.githubusercontent.com/cometapi-dev/.github/refs/heads/main/assets/img/mask_image.png"
}
'{}概覽
Bria 的 Image Editing API 提供一套完整的工具，可用於操作與增強影像。request_id 透過 查詢狀態 端點查詢結果。此介面的 sync 參數為固定值 —— 你不需要另外指定。支援的操作
| Operation | Description | Documentation |
|---|---|---|
erase | 從影像中移除物件 | Bria Erase Docs |
gen_fill | 對遮罩區域進行生成式填補 | Bria Gen Fill Docs |
expand | 擴展影像畫布 | Bria Expand Docs |
enhance | 提升影像品質 | Bria Enhance Docs |
increase_resolution | 提高影像解析度 | Bria Upscale Docs |
replace_background | 替換影像背景 | Bria Background Docs |
授權
Bearer token authentication. Use your CometAPI key.
標頭
Must be application/json.
路徑參數
Editing action to perform. Supported values: erase, gen_fill, expand, enhance, increase_resolution, replace_background.
主體
Source image as a public URL or base64-encoded data URI. Accepted formats: JPEG, PNG, WebP. Maximum 12 MB.
Mask image as a public URL or base64. White areas mark the region to edit; black areas are preserved. Required for erase, gen_fill, and expand actions.
Text description of the desired edit. Required for gen_fill and replace_background actions.
Number of result variants to generate. Default: 1.
When true, the response blocks until results are ready. When false (default), returns immediately with placeholder URLs that can be polled.
回應
Success
The response is of type object.
curl --request POST \
--url https://api.cometapi.com/bria/image/edit/{action} \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"image": "https://raw.githubusercontent.com/cometapi-dev/.github/refs/heads/main/assets/img/original_image.png",
"mask": "https://raw.githubusercontent.com/cometapi-dev/.github/refs/heads/main/assets/img/mask_image.png"
}
'{}