flux-pro-1.0-depth

flux-pro-1-0-depth 的技術規格

什麼是 flux-pro-1-0-depth？

flux-pro-1-0-depth 是 CometAPI 對 Black Forest Labs 的 FLUX Pro 1.0 Depth 模型所使用的平台識別符。這是一款具備深度感知的影像生成與編輯模型，旨在在套用基於提示的轉換時保留場景的 3D 結構。它並非將影像視為平面的像素內容，而是使用深度引導控制，使編輯更能遵循透視、物體位置與相對比例。

因此，當你希望在不喪失空間連貫性的情況下，對既有影像進行換風格或修改時，該模型特別實用。在 FLUX.1 Depth 的公開描述中，Black Forest Labs 及其生態系文件強調的使用情境包括建築場景、產品可視化、保留結構的風格遷移，以及在維持逼真幾何結構尤為重要的編輯。

另需注意，承載此模型名稱的 Black Forest Labs 原始端點已自 2025 年 10 月 31 日起宣布棄用。這並不影響你在此應使用的 CometAPI 模型代碼，但對於評估長期相容性與遷移規劃的開發者而言具參考價值。

flux-pro-1-0-depth 的主要特性

• 深度感知控制：模型利用深度引導，使生成與編輯更自然地對齊場景幾何與透視。
• 空間關係維持：旨在保留物件之間的 3D 關係，讓轉換後的構圖更可信。
• 保結構的影像轉換：FLUX 的深度流程適用於重新貼圖、可控換風格，以及在保留布局的前提下將結構化輸入轉化為更豐富的視覺效果。
• 可視化流程的強項適配：公開文件特別指出建築可視化、產品擺位與精準場景構圖是其關鍵優勢。
• 較純文字提示生成更高的創作控制：由於同時能遵循影像結構與文字指令，特別適用於要求一致性與可控性的編輯。（此為基於模型已記載的深度引導設計與既定使用情境所做的推論。）
• 專業級 FLUX 生態系整合：隸屬 FLUX Pro 工具組，面向進階影像生成與編輯流程。
• 上游端點棄用狀態：開發者應注意，Black Forest Labs 已自 2025 年 10 月 31 日起將原始 flux-pro-1.0-depth 端點標記為棄用。

如何存取與整合 flux-pro-1-0-depth

步驟 1：註冊取得 API 金鑰

首先在 CometAPI 註冊並於儀表板生成 API 金鑰。你將使用此金鑰對 flux-pro-1-0-depth API 的所有請求進行驗證。

步驟 2：向 flux-pro-1-0-depth API 發送請求

使用 CometAPI 的與 Flux 相容的端點 POST /flux/v1/{model}。

curl https://api.cometapi.com/flux/v1/flux-pro-1-0-depth \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $COMETAPI_API_KEY" \
  -d '{
    "prompt": "A breathtaking landscape painting with golden hour lighting",
    "width": 1024,
    "height": 768,
    "steps": 20,
    "prompt_upsampling": true
  }'

步驟 3：擷取並驗證結果

API 會回傳一個任務 ID。輪詢 GET /flux/v1/get_result?id={task_id} 以檢查生成狀態，並在完成後擷取輸出影像。