在 Hermes Agent 中使用 Recraft。
Recraft 提供清晰的神經網路圖片放大功能,能在不產生偽影的情況下恢復精細細節,以及精準的去背功能,能保留髮絲與透明邊緣。Hermes Agent 透過與聊天相同的 RunAPI custom provider 呼叫這兩個端點 — 傳送來源圖片 URL,選擇放大或去背,然後輪詢處理結果。
Use RunAPI to upscale an image with Recraft crisp upscale.
Requirements:
- Use the RUNAPI_API_KEY environment variable for authentication.
- Use the custom:runapi provider with base_url https://runapi.ai/v1.
- Call the RunAPI upscale_image endpoint at https://runapi.ai/api/v1/recraft/upscale_image.
- Set model to "recraft-crisp-upscale".
- Pass the source image URL in source_image_url.
- The response returns a task_id. Poll the task status endpoint until the task completes, then retrieve the upscaled image URL from the result.
- For background removal, call /api/v1/recraft/remove_background with model "recraft-remove-background" instead.
curl -X POST https://runapi.ai/api/v1/recraft/upscale_image \
-H "Authorization: Bearer $RUNAPI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "recraft-crisp-upscale",
"source_image_url": "https://example.com/product-photo.jpg"
}'
{
"task_id": "tsk_abc123",
"status": "pending",
"model": "recraft-crisp-upscale"
}
三步驟在 Hermes Agent 中使用 Recraft
設定 RunAPI
如果您尚未在 Hermes Agent 中設定 RunAPI,請依照 Hermes Agent 設定指南操作。新增名為 runapi 的 custom provider,base_url 設為 https://runapi.ai/v1,key_env 設為 RUNAPI_API_KEY,api_mode 設為 chat_completions。
export RUNAPI_API_KEY=runapi_xxx
呼叫 Recraft 放大或去背
向 upscale_image 端點發送 POST 請求,model 設為 recraft-crisp-upscale 並提供 source_image_url。若要去背,改為向 remove_background 端點發送 POST 請求,model 設為 recraft-remove-background。兩者都只需提供 source_image_url。
POST /api/v1/recraft/upscale_image
輪詢結果
兩個端點都會回傳帶有 pending 狀態的 task_id。輪詢任務狀態端點,直到狀態變為 completed,然後從回應中取得處理後的圖片 URL。RunAPI SDK 和 CLI 會自動處理輪詢。
GET /api/v1/recraft/upscale_image/tsk_abc123
Recraft API 參數
| 參數 | 類型 | 說明 |
|---|---|---|
model |
string |
必填。recraft-crisp-upscale 用於放大,recraft-remove-background 用於去背。 |
source_image_url |
string |
必填。要處理的來源圖片 URL。 |
callback_url |
string |
選填。用於非同步完成通知的 Webhook URL。 |
Hermes Agent 上的 Recraft 是什麼?
RunAPI 上的 Recraft 提供清晰的神經放大和精確的背景移除——這兩個修飾步驟能將原始 AI 生成圖像轉化為可投入生產的素材。其放大器以低於 Topaz 的成本,在設計素材和商品照上恢復精細細節。Hermes Agent 透過與生成模型相同的 custom:runapi provider 呼叫兩個端點,方便在單一工作流程中串接生成和後製處理。
Recraft 使用情境
生成後清理流程
在任何生成模型後串接 Recraft——用 Flux 2 或 Imagen 4 生成,再在單一自動化工作流程中透過背景移除和放大進行後製。
可縮放 SVG 就緒素材準備
將 AI 生成的圖示和品牌素材放大至生產解析度,為設計系統整合和跨螢幕尺寸的可縮放使用做好準備。
型錄批次去背
在單次 Hermes Agent 執行中對整個商品型錄進行背景移除,收集所有隔離的商品圖像用於電商商品列表。
Recraft + Hermes Agent 常見問題
可以。兩個端點都是無狀態的,接受標準圖片 URL。指示 Hermes Agent 先用原始圖片呼叫 remove_background,然後將輸出 URL 傳給 upscale_image。同一個 custom:runapi provider 即可處理兩次呼叫。
Recraft 接受 JPEG、PNG 和 WebP 輸入。去背輸出帶有 alpha 透明度的 PNG。放大輸出與輸入格式相同。
更改端點路徑和 model 欄位。使用 /api/v1/recraft/upscale_image 搭配 model recraft-crisp-upscale 進行放大,或使用 /api/v1/recraft/remove_background 搭配 model recraft-remove-background 進行去背。兩者使用同一個 API key 和 custom:runapi provider。
兩個 Recraft 端點都是非同步的。API 會立即回傳 task_id。輪詢任務狀態端點直到結果就緒。RunAPI SDK 和 CLI 會自動處理輪詢。
Recraft 採用按任務計費 — 放大和去背按每張處理的圖片分別計價。請查看 RunAPI 定價頁面了解最新費率。無需訂閱或最低消費。