Black Forest Labs · 圖像

Hermes Agent x Flux Kontext

Flux Kontext 是 Black Forest Labs 具情境感知能力的編輯模型,建基於 120 億參數的 Flux 架構。透過 RunAPI,Kontext Pro 及 Max 變體共用同一個 key。

2 variants 由 $0.11 / 次請求 可商用

Prerequisite: npx runapi mcp install

Prompt

Prompt 模型

任務合適時使用 flux-kontext-max:4K 輸出,文字渲染更出色,進階情境式編輯。

You have access to RunAPI task tools for Flux Kontext.

Available Flux Kontext models:
- flux-kontext-max: 4K 輸出,文字渲染更出色,進階情境式編輯
  endpoints: /api/v1/flux_kontext/text_to_image
  request fields: model, prompt
- flux-kontext-pro: 情境式編輯的速度與質素平衡
  endpoints: /api/v1/flux_kontext/text_to_image
  request fields: model, prompt

Use the model ID and endpoint that match the user's request.
Example prompt: 編輯這張產品相片:將背景換成熱帶海灘,同時保持產品完全不變。
/api/v1/flux_kontext/text_to_image: Submit the task, poll for its status, then verify the completed output. POST /api/v1/flux_kontext/text_to_image,並儲存回傳的 Task ID。
GET /api/v1/flux_kontext/text_to_image/<task-id>,直到狀態為 completed 或 failed。
確認 completed 回應包含 API 參考中記載的端點專屬輸出。

公開版本與端點

模型 ID 端點 起始價格 模型目錄
flux-kontext-max
/api/v1/flux_kontext/text_to_image
$0.17 / 次請求 模型詳情
flux-kontext-pro
/api/v1/flux_kontext/text_to_image
$0.11 / 次請求 模型詳情

驗證

輪詢,直到 Task 進入終態

選擇 <model-id> 後產生驗證命令。

設定

指南端點: <endpoint>

選擇 <model-id> 後,依端點的公開輸入契約產生請求。
使用流程

三步開始使用

  1. 選擇模型 ID

    選擇公開模型 ID,並查看其端點與目前起始價格。

  2. 設定 RunAPI

    呼叫端點前設定 RUNAPI_API_KEY。

  3. 驗證結果

    對非同步端點輪詢同一路徑,直到 Task 進入終態。

使用 Hermes Agent + Flux Kontext 可以建立甚麼

  • 多輪編輯工作流程

    依序執行多項編輯,例如調整光線、更換背景、加入文字,每一步都以前一步的結果為基礎。

  • 風格轉換流程

    在保留構圖的前提下把照片轉成油畫、素描或動漫風格,為同一內容製作多種風格版本。

  • 天氣與光線調整

    修改現有照片的時段、天氣或光線,不必重新生成整個場景。

為甚麼透過 RunAPI + Hermes Agent 使用 Flux Kontext

  • 2 個變體,一個 API 金鑰

    透過一個 RunAPI 連線選擇可用的模型變體,無需更改現有整合。

  • 清晰的用量價格

    發送請求前查看目錄中的目前價格,無需訂閱或最低消費。

  • 自動化工作流程

    透過一致的工作流程提交工作、查詢狀態並收集非同步結果,無需編寫手動輪詢程式碼。

Hermes Agent + Flux Kontext 常見問題

可以在 Hermes Agent 中使用 Flux Kontext 嗎?

可以。在 Hermes Agent 中將 RunAPI 設定為供應商,再調用本頁列出的 Flux Kontext 端點。聊天使用的同一組 RunAPI API 金鑰也能用於圖片編輯。

Hermes Agent 如何執行多步驟的 Flux Kontext 編輯?

Hermes Agent 傳送來源圖和編輯指令,再把每次的輸出當作下一次編輯的輸入,逐步修飾圖片。

編輯時如何維持角色身分不變?

傳入角色圖片,只描述需要改變的部分。Flux Kontext 預設會保留臉部特徵和比例,不需要特殊標記或參考 ID。

應該使用哪個模型 ID?

從版本表選擇公開模型 ID。每個 ID 可用的端點均列於相應資料列。

本指南會設定聊天模型嗎?

不會。此 Model Line 使用頁面所示的端點流程,不會被描述為 Agent 聊天模型。

透過 Hermes Agent 開始使用 Flux Kontext

正在與團隊一起建立?

我們可以協助企業設定、整合和技術問題。

聯絡我們