可以在 Hermes Agent 中使用 Seedream 嗎？

可以。在 Hermes Agent 中將 RunAPI 設定為 custom provider，設定 base_url 為 https://runapi.ai/v1，然後以 seedream-4.5-text-to-image 為 model 呼叫 text_to_image 端點。同一個 API key 可以同時處理聊天和圖像生成。

Seedream 需要單獨的 API key 嗎？

不需要。為 custom:runapi provider 設定的同一個 RUNAPI_API_KEY 也可以呼叫 Seedream 和 RunAPI 目錄中的所有其他圖像模型。一個 key，一個計費帳戶。

Seedream 是非同步還是同步的？

非同步。RunAPI 在首次呼叫時傳回任務 ID。輪詢任務狀態端點，直到狀態為 completed，然後從回應中取得圖像 URL。SDK 和 CLI 會自動處理輪詢。

Seedream 的價格是多少？

Seedream 按次計費。請查看 RunAPI 定價頁面取得最新價格。生成失敗不收費。

HERMES + SEEDREAM

在 Hermes Agent 中使用 Seedream。

Seedream 是字節跳動的圖像生成模型，具有強大的文字排版渲染能力和高達 4K 的輸出。Hermes Agent 透過與聊天相同的 RunAPI custom provider 和 API key 呼叫它，無需額外外掛或 GPU 租用。

取得 API Key 閱讀說明文件

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

Generate a 4K product hero image using Seedream through RunAPI.

Requirements:
- Use the RunAPI text_to_image endpoint via the custom:runapi provider.
- Set model to seedream-4.5-text-to-image.
- Read the API key from RUNAPI_API_KEY. Do not hardcode the key.
- Poll the task status endpoint until the task completes.
- Return the generated image URL from the task response.

curl -X POST https://runapi.ai/api/v1/task/text_to_image \
  -H "Authorization: Bearer $RUNAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedream-4.5-text-to-image",
    "prompt": "A premium coffee bag on a marble countertop, warm morning light, bold serif text FRESH ROAST, 4K product photography"
  }'

{
  "task_id": "tsk_abc123",
  "status": "pending",
  "model": "seedream-4.5-text-to-image"
}

複製 curl 指令進行測試 seedream

運作原理

三步在 Hermes Agent 中使用 Seedream

設定 RunAPI

若已在 Hermes Agent 中為聊天設定了 RunAPI，則無需額外操作。同一個 custom:runapi provider 和 RUNAPI_API_KEY 也可以處理圖像生成。否則，請使用 base_url https://runapi.ai/v1 新增 custom provider，並執行 hermes doctor。

export RUNAPI_API_KEY=runapi_xxx

呼叫 Seedream

向 text_to_image 端點發送請求，將 model 設為 seedream-4.5-text-to-image，並附上描述圖像的文字提示詞。RunAPI 立即傳回任務 ID。

text_to_image

取得結果

使用傳回的任務 ID 輪詢任務狀態端點。當狀態變為 completed 時，回應中包含生成的圖像 URL。RunAPI SDK 會自動處理輪詢。

task_id: tsk_abc123

參數

Seedream API 參數

參數	類型	說明
`model`	`string`	必填。seedream-4.5-text-to-image、seedream-4.5-edit、seedream-5-lite-text-to-image。
`prompt`	`string`	對所需圖像的文字描述。
`size`	`string`	選填。輸出尺寸，最高支援 4K。
`image_url`	`string`	編輯模式的來源圖像。

Hermes Agent 上的 Seedream 是什麼？

ByteDance 的 Seedream 是 LM Arena 排行榜榜首的圖像模型，以評測者稱為「保真度的巨大飛躍」的專業級輸出著稱。它能理解複雜的提示詞結構，對逼真和風格化內容均能呈現開箱即用的效果，尤其擅長在批次生成中保持一致的視覺風格。Hermes Agent 透過 RunAPI custom provider 呼叫它。