bria/generate-background 的技術規格
| 規格 | 詳細資訊 |
|---|---|
| Model ID | bria/generate-background |
| Provider | Bria |
| Category | 影像編輯 / 背景生成 |
| Core function | 將輸入影像的背景替換為新生成的背景 |
| Input types | 來源影像加上背景提示詞；可選生成控制，取決於 Bria 端點設定 |
| Output | 經編輯的影像，保留原始前景並以生成背景替換 |
| Typical use cases | 產品攝影、電商創意、棚拍風格編修、行銷素材、型錄清理，以及場景變體生成 |
| API style | HTTP API |
| Processing mode | Bria 的影像編輯 API 支援非同步處理，會回傳 request_id 與 status_url 以追蹤結果 |
| Related capability family | Bria Image Editing API，包括背景移除、背景替換、模糊、擦除、生成式填充、擴展與遮罩 |
| Base server family | Bria 將影像編輯端點記錄於 https://engine.prod.bria-api.com/v2/image/edit，並同時列出舊版 v1 支援 |
什麼是 bria/generate-background？
bria/generate-background 是 CometAPI 對應 Bria 背景生成能力的模型識別符。Bria 將此功能描述為一個可將任意影像背景替換為生成背景的 API，適用於希望保留主體並更換周邊場景的工作流程。
此模型屬於 Bria 更廣泛的 Image Editing API 套件，專為生產級影像處理而設計，如背景相關操作、物件移除、遮罩、升頻與其他定向編修。實務上，bria/generate-background 最適合在已具備前景主體（例如產品、人物或物件）時，透過文字提示將其置入由提示詞驅動的新視覺情境。
Bria 將其視覺 AI 平台定位為面向企業且可商用，並以可控的影像生成與編輯工作流程為核心提供 API。因此，bria/generate-background 對於構建自動化創意管線、媒體編輯工具、零售影像系統與品牌內容生成器的團隊特別相關。
bria/generate-background 的主要功能
- 背景替換：在保留既有影像主體的情況下替換背景，這是 Bria 背景生成能力的核心目的。
- 提示詞驅動的場景生成：開發者可用自然語言描述目標場景，生成如棚拍、戶外、零售或生活風格等新背景設定。
- 面向生產的影像編輯：屬於 Bria 專門的影像編輯技術棧，與模糊、去背、擦除、擴展與遮罩生成等能力相輔相成，適合自動化視覺內容管線。
- 支援非同步工作流程：Bria 的 v2 影像編輯 API 支援非同步執行，回傳
request_id與status_url，便於應用可靠地輪詢或追蹤完成情況。 - 商業內容工作流程：Bria 將其 API 套件定位於企業與生產使用，包括產品影像、廣告生成與可擴展媒體創作，與背景生成使用情境高度契合。
- 更大編輯生態系的一部分：可與 Bria 的相鄰能力（如去背、背景模糊、取得遮罩、升頻）結合，於同一平台構建多步驟編修流程。
如何存取與整合 bria/generate-background
步驟 1：註冊並取得 API 金鑰
要使用 bria/generate-background，請先在 CometAPI 註冊並於儀表板建立 API 金鑰。產生金鑰後請妥善保存，並在所有請求的 Authorization 標頭中使用。
步驟 2：向 bria/generate-background API 發送請求
使用 CometAPI 提供的、與 Bria 相容的端點：POST /bria/image/edit/generate-background。
curl https://api.cometapi.com/bria/image/edit/generate-background \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $COMETAPI_API_KEY" \
-d '{
"prompt": "A paper boat floating on calm water at sunrise.",
"num_results": 1
}'
步驟 3：擷取並驗證結果
API 會回傳一個任務 ID。輪詢 GET /bria/{task_id} 以檢查處理狀態，完成後取得輸出影像 URL。