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

可以。在 Hermes Agent 中將 RunAPI 設定為 custom:runapi provider，然後以 flux-kontext-pro 為 model 呼叫 text_to_image 端點。用於聊天的同一個 RUNAPI_API_KEY 也可以處理圖像生成。

Flux Kontext 需要單獨的 API key 嗎？

不需要。同一個 RUNAPI_API_KEY 適用於所有 RunAPI 模型——LLM、圖像、影片和音樂。一個 key，一個計費帳戶。

Flux Kontext 是非同步還是同步的？

非同步。API 立即傳回任務 ID。輪詢任務狀態端點或使用 webhook 回呼接收已完成的圖像 URL。

Flux Kontext 的價格是多少？

Flux Kontext Pro 起價每張 2.5 美分。Flux Kontext Max 精度更高，價格也更高。請查看 RunAPI 定價頁面取得最新價格——按用量計費，無需訂閱。

HERMES + FLUX KONTEXT

在 Hermes Agent 中使用 Flux Kontext。

Flux Kontext 由 Black Forest Labs 出品，支援文字引導的圖像編輯和生成，並保持角色一致性。Hermes Agent 透過 RunAPI 的 custom:runapi provider 呼叫它，與聊天使用相同的 key 和 base URL。

取得 API Key 閱讀說明文件

一個 API key · 文生圖端點 · 非同步任務輪詢

Use RunAPI to generate an image with Flux Kontext Pro through Hermes Agent.

Requirements:
- Use the custom:runapi provider already configured in Hermes Agent
- Call the RunAPI text_to_image endpoint at https://runapi.ai/v1/text_to_image
- Set model to "flux-kontext-pro"
- The RUNAPI_API_KEY environment variable provides authorization
- The response is async — poll the task status endpoint until the task completes, then retrieve the image URL

curl -X POST https://runapi.ai/v1/text_to_image \
  -H "Authorization: Bearer $RUNAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "flux-kontext-pro",
    "prompt": "a matte-black water bottle on a beige stone surface, soft side light, studio photography"
  }'

{
  "task_id": "tsk_abc123",
  "status": "pending",
  "model": "flux-kontext-pro"
}

複製 curl 指令進行測試 flux-kontext

運作原理

三步在 Hermes Agent 中使用 Flux Kontext

設定 RunAPI

設定 RUNAPI_API_KEY 環境變數。若已在 Hermes Agent 中將 RunAPI 設定為 custom:runapi provider 用於聊天，同一個 key 和 base_url 也適用於圖像生成，無需額外設定。

export RUNAPI_API_KEY=runapi_xxx

呼叫 Flux Kontext

向 text_to_image 端點發送 POST 請求，將 model 設為 flux-kontext-pro，並附上描述所需圖像的文字提示詞。如需上下文內編輯，可選填 image_url。

text_to_image

取得結果

端點傳回一個任務 ID。輪詢任務狀態端點，直到狀態變為 completed，然後從回應中取得生成的圖像 URL。

task_id: tsk_abc123

參數

Flux Kontext API 參數

參數	類型	說明
`model`	`string`	必填。flux-kontext-pro 或 flux-kontext-max。
`prompt`	`string`	用於生成或編輯的文字指令。
`image_url`	`string`	用於上下文內編輯的來源圖像 URL。
`aspect_ratio`	`string`	選填。輸出長寬比。

Hermes Agent 上的 Flux Kontext 是什麼？

Flux Kontext 是 Black Forest Labs 基於 120 億參數整流流轉換器構建的指令式圖像編輯器，支援多輪編輯——可依序串接多次編輯，模型會保留每個前置步驟的上下文。Hermes Agent 透過 RunAPI custom provider 端點呼叫它，方便構建多步驟編輯流程。