你將建立的內容
你將使用POST /flux/v1/flux-dev 建立一個 Flux 圖片生成任務,輪詢 GET /flux/v1/get_result,並在任務就緒時下載產生出的圖片 URL。
先決條件
- 儲存在
COMETAPI_KEY中的 CometAPI API key - Python 3.10+ 與
requests,或 Node.js 18+ - 來自 Flux API 參考文件或 Models 的 Flux 模型路徑
API key、基礎 URL、驗證
Flux 生成會在 URL 路徑中使用模型名稱:程式碼範例
使用下方分頁查看可複製的 cURL、Python 與 Node.js 範例。流程說明
Flux 生成是非同步的。建立端點會回傳任務id。持續輪詢 /flux/v1/get_result?id=<task_id>,直到 status 為 Ready,接著下載 result.sample。
Flux 結果 URL 具有時間限制。當你的應用程式需要持久存取時,請將已完成的圖片複製到你自己的儲存空間中。
常見參數
疑難排解 / 常見問題
任務一直處於 pending
任務一直處於 pending
持續使用具有限制重試次數與逾時設定的輪詢迴圈。請儲存 task ID,以便稍後檢查該工作。
圖片 URL 已過期
圖片 URL 已過期
在任務變為
Ready 後,盡快下載 result.sample,然後將圖片儲存到你自己的儲存空間。Flux 參數失敗
Flux 參數失敗
Flux 參數支援會因 model variant 而異。請先使用
prompt、width 和 height,再於加入選用欄位前查閱 Flux API 參考文件。後續步驟
- 閱讀 Flux generate image API reference。
- 使用 Get Flux image result 輪詢結果。
- 在 Models 中查找 Flux 模型。
- 使用 Estimate request cost before calling a model 估算成本。