Use Recraft in Hermes Agent.
Recraft provides crisp neural image upscaling that recovers fine detail without artifacts, and precise background removal that preserves hair strands and transparent edges. Hermes Agent calls both endpoints through the same RunAPI custom provider used for chat — send a source image URL, choose upscale or background removal, and poll for the processed result.
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"
}
Use Recraft in Hermes Agent in three steps
Configure RunAPI
If you have not set up RunAPI in Hermes Agent yet, follow the Hermes Agent setup guide. Add a custom provider named runapi with base_url https://runapi.ai/v1, key_env RUNAPI_API_KEY, and api_mode chat_completions.
export RUNAPI_API_KEY=runapi_xxx
Call Recraft upscale or remove background
Send a POST request to the upscale_image endpoint with model set to recraft-crisp-upscale and provide the source_image_url. For background removal, POST to the remove_background endpoint with model recraft-remove-background instead. Both require only source_image_url.
POST /api/v1/recraft/upscale_image
Poll for the result
Both endpoints return a task_id with status pending. Poll the task status endpoint until the status changes to completed, then retrieve the processed image URL from the response. RunAPI SDKs and the CLI handle polling automatically.
GET /api/v1/recraft/upscale_image/tsk_abc123
Recraft API parameters
| Parameter | Type | Description |
|---|---|---|
model |
string |
Required. recraft-crisp-upscale for upscaling, recraft-remove-background for background removal. |
source_image_url |
string |
Required. URL of the source image to process. |
callback_url |
string |
Optional. Webhook URL for async completion notification. |
What is Recraft on Hermes Agent?
Recraft on RunAPI provides crisp neural upscaling and precision background removal -- two finishing steps that turn raw AI-generated images into production-ready assets. The upscaler recovers fine detail on design assets and product photos at lower cost than Topaz. Hermes Agent calls both endpoints through the same custom:runapi provider used for generation models, making it straightforward to chain generation and post-processing in one workflow.
Recraft use cases
Post-generation cleanup pipeline
Chain Recraft after any generation model -- generate with Flux 2 or Imagen 4, then pass the output through background removal and upscaling in one automated workflow.
Scalable SVG-ready asset preparation
Upscale AI-generated icons and brand assets to production resolution, preparing them for design system integration and scalable use across screen sizes.
Batch background removal for catalogs
Process entire product catalogs through background removal in a single Hermes Agent run, collecting all isolated product images for e-commerce listings.
Recraft + Hermes Agent questions
Yes. Both endpoints are stateless and accept standard image URLs. Instruct the Hermes Agent to first call remove_background with the original image, then pass the output URL to upscale_image. The same custom:runapi provider handles both calls.
Recraft accepts JPEG, PNG, and WebP inputs. Background removal outputs PNG with alpha transparency. Upscale output matches the input format.
Change the endpoint path and model field. Use /api/v1/recraft/upscale_image with model recraft-crisp-upscale for upscaling, or /api/v1/recraft/remove_background with model recraft-remove-background for background removal. Both use the same API key and custom:runapi provider.
Specify the endpoint action in your request — use the upscale endpoint for resolution enhancement or the background_removal endpoint for subject extraction. Hermes Agent routes each request to the correct Recraft action through the custom:runapi provider.
Yes. Hermes Agent can loop over a list of image URLs and call Recraft's background removal or upscale endpoint for each one, collecting all processed images when the batch completes.
Hermes Agent general setup
Not configured yet? Start with the RunAPI setup guide for Hermes Agent.
Hermes Agent setup guide →Try Recraft in Hermes Agent today.
Get a free RunAPI key, configure the custom provider, and start upscaling images and removing backgrounds with Recraft.