在 Hermes Agent 中使用 Seedream。
Seedream 是 Bytedance 的圖像生成模型，具備強大的排版渲染能力，輸出最高可達 4K。Hermes Agent 透過與聊天相同的 RunAPI 自訂 provider 和 API key 呼叫它——無需額外插件或 GPU 租用。
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"
}
三步驟在 Hermes Agent 中使用 Seedream
設定 RunAPI
如果你已在 Hermes Agent 中為聊天設定了 RunAPI，則無需額外操作。同一個 custom:runapi provider 和 RUNAPI_API_KEY 亦可處理圖像生成。如尚未設定，請以 base_url https://runapi.ai/v1 新增自訂 provider，然後執行 hermes doctor。
export RUNAPI_API_KEY=runapi_xxx
呼叫 Seedream
向 text_to_image 端點發送請求，將 model 設為 seedream-4.5-text-to-image，並附上描述圖像的文字 prompt。RunAPI 立即返回 task ID。
text_to_image
取得結果
使用返回的 task ID 輪詢 task status 端點。當狀態變為 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 是什麼？
字節跳動的 Seedream 是 LM Arena 排行榜榜首圖像模型，以專業級輸出著稱。它理解複雜提示詞結構，對寫實和風格化內容均能開箱即用，在批量生成中保持一致視覺風格方面尤為出色。Hermes Agent 通過 RunAPI custom provider 呼叫它。
Seedream 使用場景
社交媒體營銷活動
跨整個活動生成一致的品牌代言人圖像，模型在數十個輸出中保持相同的角色外觀和品牌識別度。
書籍封面與產品包裝設計
以 4K 分辨率創作書籍封面、產品包裝和標籤設計，文字渲染精準，排版控制精確。
品牌視覺識別開發
探索品牌識別的多個視覺方向——標誌、配色方案、產品效果圖——Seedream 出色的提示詞遵從性確保每個變體都忠實於設計簡報。
Seedream + Hermes Agent 常見問題
可以。在 Hermes Agent 中將 RunAPI 設定為自訂 provider，base_url 設為 https://runapi.ai/v1，然後以 model 設為 seedream-4.5-text-to-image 呼叫 text_to_image 端點。同一個 API key 同時處理聊天和圖像生成。
不需要。用於 custom:runapi provider 的同一個 RUNAPI_API_KEY 亦可呼叫 Seedream 及 RunAPI 目錄中的所有其他圖像模型。一個 key，一個計費帳戶。
非同步。RunAPI 在第一次呼叫時返回 task ID。輪詢 task status 端點直到狀態為 completed，然後從回應中取得圖像 URL。SDK 和 CLI 會自動處理輪詢。
Seedream 按每次生成計費。請查看 RunAPI 收費頁面了解最新價格。生成失敗不收費。