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

# Usa Ideogram V3 in Hermes Agent.

Ideogram V3 genera immagini con un rendering del testo senza eguali nel settore — tipografia leggibile su poster, loghi e insegne che altri modelli di immagini faticano a gestire. Offre tre endpoint (text_to_image, edit_image, remix_image) e un livello di velocità turbo che dimezza il tempo di generazione a costo ridotto. Hermes Agent lo chiama tramite lo stesso provider personalizzato RunAPI e la stessa API key usati per la chat, senza plugin aggiuntivi da installare.

## API example

```bash
curl -X POST https://runapi.ai/v1/text_to_image \
  -H "Authorization: Bearer $RUNAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "ideogram-v3-text-to-image",
    "prompt": "A minimalist cafe menu poster, cream background, the text FRESH BREWED written in elegant serif font at the top, three coffee cup illustrations below, warm earth tones",
    "style": "design",
    "aspect_ratio": "3:4",
    "rendering_speed": "balanced"
  }'

```

### Response

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

```

## How it works

1. **Configura RunAPI** — Imposta la variabile d'ambiente RUNAPI_API_KEY nel tuo profilo shell. Se il provider custom:runapi è già configurato in Hermes Agent per la chat, la stessa key funziona per Ideogram V3 — nessuna configurazione aggiuntiva necessaria.
2. **Chiama Ideogram V3** — Invia una richiesta POST all'endpoint text_to_image con model impostato su ideogram-v3-text-to-image. Includi nel prompt qualsiasi testo che vuoi renderizzato nell'immagine. Imposta style su design per lavori su poster e loghi, o realistic per output fotografico. Usa rendering_speed turbo per risultati più veloci a costo inferiore.
3. **Ottieni il risultato** — L'API restituisce immediatamente un task_id. Esegui il polling dell'endpoint di stato del task finché lo stato non cambia in completed, poi recupera l'URL dell'immagine di output dalla risposta. Richiedi fino a 4 immagini per chiamata con output_count.

## Parameters

| Parameter | Type | Description |
|-----------|------|-------------|
| `model` | `string` | Obbligatorio. ideogram-v3-text-to-image, ideogram-v3-edit, o ideogram-v3-remix. |
| `prompt` | `string` | Descrizione testuale dell'immagine desiderata. Includi il testo specifico che vuoi renderizzato. |
| `style` | `string` | Facoltativo. auto, general, realistic, o design. Usa design per poster e loghi. |
| `rendering_speed` | `string` | Facoltativo. turbo (più veloce, costo minore), balanced (predefinito), o quality (massimo dettaglio). |
| `aspect_ratio` | `string` | Facoltativo. 1:1, 3:4, 9:16, 4:3, o 16:9. |
| `output_count` | `integer` | Facoltativo. Numero di immagini da generare per richiesta. Da 1 a 4. |
| `source_image_url` | `string` | Obbligatorio per gli endpoint edit e remix. URL dell'immagine sorgente. |

## FAQ

### Come gestisce Ideogram V3 il testo nelle immagini rispetto agli altri modelli?

Ideogram V3 è specificamente ottimizzato per il rendering della tipografia. Può produrre testo multiriga leggibile, intestazioni stilizzate e caratteri di qualità logo che modelli come Flux o Imagen spesso distorcono. Se il tuo caso d'uso richiede testo accurato su poster, insegne o etichette di prodotto, Ideogram V3 è l'opzione più solida nel catalogo RunAPI.

### Qual è la differenza tra le velocità di rendering turbo, balanced e quality?

Turbo genera il più velocemente a circa la metà del costo di balanced. Quality produce l'output con il massimo dettaglio ma richiede più tempo. Balanced è il punto di equilibrio predefinito. Tutti e tre i livelli usano lo stesso modello Ideogram V3 sottostante — la differenza è il tempo di calcolo e la fedeltà, non la versione del modello.

### Come configuro il provider custom:runapi in Hermes Agent per Ideogram V3?

Aggiungi un provider personalizzato con base_url https://runapi.ai/v1 e la tua RUNAPI_API_KEY nella configurazione del provider di Hermes Agent. Una volta configurato, chiama qualsiasi endpoint RunAPI — text_to_image, edit_image, remix_image — tramite lo stesso provider. Esegui hermes doctor per verificare la connessione.

### Posso usare la modalità remix per trasferire lo stile di un'immagine a un'altra?

Sì. Usa l'endpoint remix_image con model impostato su ideogram-v3-remix. Passa source_image_url con l'immagine di riferimento dello stile, poi descrivi la nuova composizione nel prompt. L'output eredita lo stile visivo della sorgente seguendo il prompt testuale per il contenuto. Puoi anche impostare style su design, realistic o general per guidare ulteriormente l'output.

### Come funziona il pricing per immagine con output_count?

Ogni immagine generata viene fatturata separatamente. Se imposti output_count su 4, ti vengono addebitate 4 immagini. La tariffa per immagine dipende dall'impostazione rendering_speed — turbo costa circa la metà di balanced. Consulta la pagina dei prezzi di RunAPI per le tariffe aggiornate. Le generazioni non riuscite non vengono addebitate.


## Links

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