bria/expand-image 的技術規格
| 規格 | 詳細資訊 |
|---|---|
| 模型 ID | bria/expand-image |
| 提供方／模型系列 | Bria Expand，Bria 提供的圖像擴展與外延繪製模型 |
| 主要任務 | 透過產生新像素，將圖像擴展至原始邊界之外，以適配更寬或更高的構圖 |
| API 操作類型 | 圖像編輯／外延繪製端點 |
| Bria 官方端點 | Bria 的圖像編輯 API 上的 POST /v2/image/edit/expand |
| 輸入圖像格式 | JPEG、JPG、PNG、WEBP；圖像可作為 base64 或可公開存取的 URL 提供 |
| 輸出行為 | 返回擴展後的圖像 URL；Bria v2 可視處理模式返回同步結果，或附帶 request_id 與 status_url 的非同步回應 |
| 長寬比控制 | 支援預設比例（如 1:1、2:3、3:2、3:4、4:3、4:5、5:4、9:16、16:9），並可設定 0.5 至 3.0 的自訂浮點比例 |
| 畫布控制 | 在未使用 aspect_ratio 時，可明確指定 canvas_size、original_image_size 與 original_image_location |
| 畫布限制 | 建議畫布總面積在 5000×5000 像素以內；若明確設定畫布大小，最大允許面積為 2,500 萬像素 |
| 提示詞支援 | 可選的英文提示詞可引導擴展；若省略，Bria 可從輸入圖像自動生成提示詞 |
| 審核選項 | 在 Bria API 中支援提示詞審核與視覺輸出審核控制 |
| 商業定位 | Bria 表示該模型僅以授權資料訓練，以支援更安全的商業使用 |
什麼是 bria/expand-image？
bria/expand-image 是 CometAPI 用於標識 Bria 圖像擴展模型的平台 ID，旨在在保持視覺連貫性的同時，將既有圖像延伸至原始邊界之外。實務上，它是一種外延繪製模型：並非為了符合新格式而裁切圖像，而是在原圖周圍產生額外內容，使最終結果對齊目標長寬比或畫布版面。
此模型適用於多種流程，例如為社群媒體版位調整創意、將直向圖變為橫幅、在主體周圍創造額外背景，或在不需手動編輯每個素材的情況下重構產品與行銷視覺。Bria 的文件將此能力歸於其更廣泛的圖像編輯 API 套件，並與背景編輯、擦除、生成人像填充與升頻等工具並列。
Bria 的一項重要定位是企業級與商業就緒。Bria 表示其模型以授權資料訓練，並定位為適合較低風險的商業使用，這對於建立生產設計、品牌或電商管線的團隊可能相當重要。
bria/expand-image 的主要功能
- 高品質圖像外延繪製: 透過在邊界外產生新像素延伸場景，而非僅拉伸或裁切來源圖像。
- 長寬比適配: 可擴展至常見目標格式，如
16:9、9:16、1:1等，便於跨渠道重用單一素材。 - 精確畫布定位: 支援
canvas_size、original_image_size與original_image_location，可精確控制原圖在新構圖中的位置。 - 可選提示詞引導: 接受文字提示詞以引導新生成區域；若未提供，服務可自動從圖像推導提示詞。
- 彈性輸入方式: 支援 base64 編碼圖像或可公開存取的圖像 URL，便於串接網頁應用、資產管線與自動化系統。
- 適合生產環境的 API 流程: Bria v2 支援附帶
request_id與status_url的非同步處理，利於較長任務與後端協作。 - 內建審核選項: 提供提示詞與輸出內容審核設定，以協助在生產整合中落實政策控管。
- 商業可用定位: Bria 將模型定位為以授權資料訓練，較適合商業部署，契合企業內容營運需求。
如何存取並整合 bria/expand-image
步驟 1：註冊取得 API 金鑰
首先在 CometAPI 註冊，並於儀表板產生你的 API 金鑰。取得金鑰後，即可對 bria/expand-image 與平台上其他受支援的模型進行驗證請求。
步驟 2：向 bria/expand-image API 發送請求
使用 CometAPI 與 Bria 相容的端點 POST /bria/image/edit/expand-image。
curl https://api.cometapi.com/bria/image/edit/expand-image \
-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。