HERMES + FLUX 2

在 Hermes Agent 中使用 Flux 2。

Black Forest Labs 的 Flux 2 提供兩種品質層級 — Pro 以每張 5 美分快速生成,Flex 以 14 美分產出更高保真度。兩者都支援文生圖和多來源 remix,可選 1k 或 2k 解析度。Hermes Agent 透過 custom:runapi provider 呼叫 — 使用與聊天相同的 key 和 base URL。

一個 API key · 文生圖 + remix 端點 · 1k / 2k 解析度
Use RunAPI to generate an image with Flux 2 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-2-pro-text-to-image"
- The RUNAPI_API_KEY environment variable provides authorization
- Optionally set output_resolution to "1k" or "2k" and aspect_ratio to control dimensions
- 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-2-pro-text-to-image",
    "prompt": "a ceramic vase with dried flowers on a linen tablecloth, natural window light, 35mm film grain",
    "aspect_ratio": "3:4",
    "output_resolution": "2k"
  }'
{
  "task_id": "tsk_abc123",
  "status": "pending",
  "model": "flux-2-pro-text-to-image"
}
複製 curl 指令進行測試 flux-2
運作原理

三步驟在 Hermes Agent 中使用 Flux 2

1

設定 RunAPI

設定 RUNAPI_API_KEY 環境變數。如果您已在 Hermes Agent 中將 RunAPI 新增為 custom:runapi provider 用於聊天,同一個 key 和 base_url 也適用於 Flux 2 圖片生成 — 無需額外設定。

export RUNAPI_API_KEY=runapi_xxx
2

呼叫 Flux 2

向 text_to_image 端點發送 POST 請求,model 設為 flux-2-pro-text-to-image。加入 prompt,並可選擇性設定 aspect_ratio(1:1、4:3、16:9 等)和 output_resolution(1k 或 2k)。若要進行多來源 remix,改用 remix_image 端點搭配 source_image_urls。

text_to_image
3

取得結果

端點會回傳一個任務 ID。輪詢任務狀態端點,直到狀態變為 completed,然後從回應中取得生成的圖片 URL。RunAPI SDK 和 CLI 會自動處理輪詢。

task_id: tsk_abc123
參數

Flux 2 API 參數

參數 類型 說明
model string 必填。flux-2-pro-text-to-image、flux-2-flex-text-to-image、flux-2-pro-remix-image 或 flux-2-flex-remix-image。
prompt string 要生成的圖片文字描述。
aspect_ratio string 選填。輸出長寬比:1:1、4:3、3:4、16:9、9:16、3:2 或 2:3。Remix 端點還接受 auto。
output_resolution string 選填。1k(預設)或 2k。較高解析度的每張圖片費用較高。
source_image_urls array remix_image 必填。要混合或轉換的來源圖片 URL 陣列。
callback_url string 選填。用於非同步完成通知的 Webhook URL。

Hermes Agent 上的 Flux 2 是什麼?

Black Forest Labs 的 Flux 2 提供材質保真度高的寫實圖像生成。Hermes Agent 通過 RunAPI custom provider 呼叫 Flux 2,實現規模化迭代——從同一提示詞生成數十個品牌一致的變體,無需手工微調。

Flux 2 使用場景

規模化品牌一致性圖像

從同一提示詞生成數十個品牌一致的圖像變體,Hermes Agent 並行調度 Flux 2 任務並收集所有結果,無需手工處理每個輸出。

生活方式與編輯攝影替代

以精準的光線、景深和材質效果生成生活方式攝影和編輯攝影內容,替代圖庫照片授權,用於營銷活動。

遊戲與創意項目概念圖

為遊戲開發、電影或創意項目生成寫實環境、角色設計和道具概念圖,400 萬像素的輸出提供足夠細節用於進一步製作。

FAQ

Flux 2 + Hermes Agent 常見問題

Hermes Agent 通用設定

尚未設定?請從 Hermes Agent 的 RunAPI 設定指南開始。

Hermes Agent 設定指南 →

Flux 2 模型目錄

查看所有 Flux 2 變體、定價與 API 文件。

Flux 2 模型 →

立即在 Hermes Agent 中試用 Flux 2。

取得免費的 RunAPI key,設定 custom:runapi provider,即可開始使用 Flux 2 Pro 或 Flex 生成圖片。