Usa Ideogram V3 in OpenClaw.
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. Gli agenti OpenClaw lo chiamano tramite la stessa API key e l'endpoint /v1 usati per la chat, senza competenze aggiuntive da installare.
Usa RunAPI per generare un'immagine con un rendering accurato del testo usando Ideogram V3.
Requisiti:
- Usa la API RunAPI su https://runapi.ai/v1/text_to_image.
- Leggi la API key dalla variabile d'ambiente RUNAPI_API_KEY.
- Imposta il model su "ideogram-v3-text-to-image".
- Scrivi un prompt che includa il testo specifico che vuoi renderizzato nell'immagine.
- Facoltativamente imposta rendering_speed su turbo per una generazione più veloce, o su quality per i migliori risultati.
- La risposta restituisce un task_id. Esegui il polling dell'endpoint di stato del task finché il task non è completato, poi recupera l'URL dell'output.
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"
}'
{
"task_id": "tsk_abc123",
"status": "pending",
"model": "ideogram-v3-text-to-image"
}
Usa Ideogram V3 in OpenClaw in tre passaggi
Configura RunAPI
Imposta la variabile d'ambiente RUNAPI_API_KEY nel tuo profilo shell. Se RunAPI è già configurato in OpenClaw per la chat, la stessa key funziona per Ideogram V3 — nessuna configurazione aggiuntiva necessaria.
export RUNAPI_API_KEY=runapi_xxx
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.
POST /v1/text_to_image
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.
task_id: tsk_abc123
Parametri API Ideogram V3
| Parametro | Tipo | Descrizione |
|---|---|---|
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. |
Cos'è Ideogram V3 su OpenClaw?
Ideogram V3 è il modello che gli utenti chiamano un "game changer" per la tipografia nelle immagini generate -- centra testo nitido e professionale che modelli concorrenti come Midjourney faticano a ottenere correttamente anche dopo 15+ tentativi producendo risultati illeggibili. Raggiunge il 90-95 % di precisione del testo al primo o secondo tentativo, con supporto per riferimenti di stile per mantenere la coerenza del brand. Gli agenti OpenClaw lo chiamano tramite la stessa chiave RunAPI usata per la chat.
Casi d'uso di Ideogram V3
Esplorazione di loghi e identità del brand
Generare concept di loghi con nomi aziendali correttamente renderizzati, esplorando molteplici direzioni visive per il lavoro sull'identità del brand senza composizione manuale del testo.
Miniature YouTube e grafiche social
Creare miniature che invitano al clic, pin di Pinterest e grafiche per i social media con testo in grassetto leggibile che si renderizza correttamente al primo tentativo.
Mockup di prodotti e listini e-commerce
Generare mockup di prodotti con etichette precise, testo dei prezzi e callout delle caratteristiche per presentazioni ai clienti o pagine prodotto e-commerce.
Domande su Ideogram V3 + OpenClaw
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.
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.
Sì. Usa l'endpoint edit_image con ideogram-v3-edit per modificare un'immagine sorgente guidata da un prompt testuale. Usa l'endpoint remix_image con ideogram-v3-remix per trasferire lo stile di un'immagine sorgente a una nuova composizione. Entrambi richiedono source_image_url come parametro.
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.
Asincrono. L'API restituisce immediatamente un task_id. Esegui il polling dell'endpoint di stato del task finché il task non è completato. Gli SDK RunAPI e la CLI gestiscono automaticamente il polling. Le generazioni non riuscite non vengono addebitate.
Configurazione generale di OpenClaw
Non ancora configurato? Inizia con la guida di configurazione RunAPI per OpenClaw.
Guida di configurazione di OpenClaw →Catalogo modelli Ideogram V3
Vedi tutte le varianti Ideogram V3, i prezzi e la documentazione API.
Modelli Ideogram V3 →Prova Ideogram V3 in OpenClaw oggi.
Ottieni una API key RunAPI gratuita, incolla il prompt in OpenClaw e inizia a generare immagini con tipografia accurata usando Ideogram V3.