---
title: "Use Recraft in Hermes Agent via RunAPI — Upscale & BG Removal"
url: "https://runapi.ai/hermes-recraft.md"
canonical: "https://runapi.ai/hermes-recraft"
locale: "en"
model: "recraft"
---

# 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.

## API example

```bash
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"
  }'

```

### Response

```json
{
  "task_id": "tsk_abc123",
  "status": "pending",
  "model": "recraft-crisp-upscale"
}

```

## How it works

1. **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.
2. **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.
3. **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.

## 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. |

## FAQ

### Can I chain Recraft background removal and upscaling in one Hermes Agent workflow?

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.

### What image formats does Recraft accept and output?

Recraft accepts JPEG, PNG, and WebP inputs. Background removal outputs PNG with alpha transparency. Upscale output matches the input format.

### How do I switch between upscale and background removal in Hermes Agent?

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.

### How does Hermes Agent select between Recraft's upscale and background removal endpoints?

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.

### Can Hermes Agent process a batch of images through Recraft in one workflow?

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.


## Links

- [Hermes Agent setup guide →](https://runapi.ai/hermes-agent)
- [Recraft models →](https://runapi.ai/models/recraft)
- [Model catalog](https://runapi.ai/models)
- [API docs](https://runapi.ai/docs)