---
title: "Usa Recraft in Hermes Agent tramite RunAPI — Upscale e Rimozione Sfondo"
url: "https://runapi.ai/it/hermes-recraft.md"
canonical: "https://runapi.ai/it/hermes-recraft"
locale: "it"
model: "recraft"
---

# Usa Recraft in Hermes Agent.

Recraft fornisce un upscaling neurale nitido che recupera i dettagli fini senza artefatti, e una rimozione sfondo precisa che preserva i capelli e i bordi trasparenti. Hermes Agent chiama entrambi gli endpoint tramite lo stesso provider custom RunAPI usato per la chat — invia un URL immagine sorgente, scegli upscaling o rimozione sfondo, e attendi il risultato elaborato.

## 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. **Configura RunAPI** — Se non hai ancora configurato RunAPI in Hermes Agent, segui la guida di configurazione di Hermes Agent. Aggiungi un provider custom chiamato runapi con base_url https://runapi.ai/v1, key_env RUNAPI_API_KEY e api_mode chat_completions.
2. **Chiama Recraft upscale o rimuovi sfondo** — Invia una richiesta POST all'endpoint upscale_image con model impostato su recraft-crisp-upscale e fornisci il source_image_url. Per la rimozione sfondo, invia una POST all'endpoint remove_background con model recraft-remove-background. Entrambi richiedono solo source_image_url.
3. **Ottieni il risultato** — Entrambi gli endpoint restituiscono un task_id con stato pending. Esegui il polling dell'endpoint di stato del task finché lo stato non cambia in completed, poi recupera l'URL dell'immagine elaborata dalla risposta. Gli SDK RunAPI e la CLI gestiscono il polling automaticamente.

## Parameters

| Parameter | Type | Description |
|-----------|------|-------------|
| `model` | `string` | Obbligatorio. recraft-crisp-upscale per l'upscaling, recraft-remove-background per la rimozione sfondo. |
| `source_image_url` | `string` | Obbligatorio. URL dell'immagine sorgente da elaborare. |
| `callback_url` | `string` | Facoltativo. URL webhook per la notifica asincrona di completamento. |

## FAQ

### Posso concatenare la rimozione sfondo e l'upscaling di Recraft in un unico flusso di lavoro Hermes Agent?

Sì. Entrambi gli endpoint sono stateless e accettano URL di immagini standard. Istruisci Hermes Agent a chiamare prima remove_background con l'immagine originale, poi passare l'URL dell'output a upscale_image. Lo stesso provider custom:runapi gestisce entrambe le chiamate.

### Quali formati immagine accetta e produce Recraft?

Recraft accetta input JPEG, PNG e WebP. La rimozione sfondo produce output PNG con trasparenza alpha. L'output dell'upscaling corrisponde al formato di input.

### Come faccio a passare tra upscale e rimozione sfondo in Hermes Agent?

Cambia il percorso dell'endpoint e il campo model. Usa /api/v1/recraft/upscale_image con model recraft-crisp-upscale per l'upscaling, oppure /api/v1/recraft/remove_background con model recraft-remove-background per la rimozione sfondo. Entrambi usano la stessa API key e il provider custom:runapi.

### L'elaborazione di Recraft è asincrona o sincrona?

Entrambi gli endpoint Recraft sono asincroni. L'API restituisce immediatamente un task_id. Esegui il polling dell'endpoint di stato del task finché il risultato non è pronto. Gli SDK RunAPI e la CLI gestiscono il polling automaticamente.

### Quanto costa Recraft su RunAPI?

Recraft usa la fatturazione per task — upscaling e rimozione sfondo sono prezzati separatamente per immagine elaborata. Controlla la pagina dei prezzi di RunAPI per le tariffe aggiornate. Nessun abbonamento o spesa minima richiesti.


## Links

- [Guida di configurazione di Hermes Agent →](https://runapi.ai/it/hermes-agent)
- [Modelli Recraft →](https://runapi.ai/it/models/recraft)
- [Model catalog](https://runapi.ai/it/models)
- [API docs](https://runapi.ai/it/docs)