---
title: "Usa Seedream in Hermes Agent tramite RunAPI — Guida API Immagini"
url: "https://runapi.ai/it/hermes-seedream.md"
canonical: "https://runapi.ai/it/hermes-seedream"
locale: "it"
model: "seedream"
---

# Usa Seedream in Hermes Agent.

Seedream è il modello di generazione di immagini di Bytedance con forte rendering tipografico e output fino a 4K. Hermes Agent lo chiama tramite lo stesso provider RunAPI personalizzato e API key usati per la chat — senza plugin aggiuntivi o noleggio GPU.

## API example

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

```

### Response

```json
{
  "task_id": "tsk_abc123",
  "status": "pending",
  "model": "seedream-4.5-text-to-image"
}

```

## How it works

1. **Configura RunAPI** — Se hai già configurato RunAPI in Hermes Agent per la chat, sei a posto. Lo stesso provider custom:runapi e RUNAPI_API_KEY gestiscono la generazione di immagini. Altrimenti, aggiungi il provider personalizzato con base_url https://runapi.ai/v1 ed esegui hermes doctor.
2. **Chiama Seedream** — Invia una richiesta all'endpoint text_to_image con model impostato su seedream-4.5-text-to-image. Includi un prompt di testo che descrive l'immagine. RunAPI restituisce immediatamente un task ID.
3. **Ottieni il risultato** — Esegui il polling dell'endpoint di stato del task con il task ID restituito. Quando lo stato cambia in completed, la risposta include l'URL dell'immagine generata. Gli SDK RunAPI gestiscono il polling automaticamente.

## Parameters

| Parameter | Type | Description |
|-----------|------|-------------|
| `model` | `string` | Obbligatorio. seedream-4.5-text-to-image, seedream-4.5-edit, seedream-5-lite-text-to-image. |
| `prompt` | `string` | Descrizione testuale dell'immagine desiderata. |
| `size` | `string` | Facoltativo. Dimensioni dell'output. Supporta fino a 4K. |
| `image_url` | `string` | Immagine sorgente per la modalità di modifica. |

## FAQ

### Posso usare Seedream in Hermes Agent?

Sì. Configura RunAPI come provider personalizzato in Hermes Agent con base_url https://runapi.ai/v1, poi chiama l'endpoint text_to_image con model impostato su seedream-4.5-text-to-image. La stessa API key gestisce sia la chat che la generazione di immagini.

### Ho bisogno di una API key separata per Seedream?

No. La stessa RUNAPI_API_KEY che hai configurato per il provider custom:runapi chiama anche Seedream e tutti gli altri modelli di immagini nel catalogo RunAPI. Una sola key, un solo account di fatturazione.

### Seedream è asincrono o sincrono?

Asincrono. RunAPI restituisce un task ID alla prima chiamata. Esegui il polling dell'endpoint di stato del task finché lo stato non è completed, poi recupera l'URL dell'immagine dalla risposta. Gli SDK e la CLI gestiscono il polling automaticamente.

### Quanto costa Seedream?

Seedream usa prezzi per generazione. Controlla la pagina dei prezzi di RunAPI per le tariffe aggiornate. Le generazioni fallite non vengono addebitate.


## Links

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