OpenClaw supporta chat, image_generate, video_generate e music_generate — ma la maggior parte dei provider API copre solo uno o due. RunAPI copre tutti e quattro con una sola chiave, oltre 113 modelli da 18 provider e prezzi pay-as-you-go a partire da 2 centesimi per chiamata.
Configure RunAPI as an API provider in this OpenClaw workspace.
- Add a provider named "runapi" with baseUrl "https://runapi.ai/v1".
- Read the API key from RUNAPI_API_KEY. Do not hardcode the key.
- Use api "openai-completions".
- Register model id "gpt-5.5" with display name "RunAPI GPT 5.5".
- Set the default model to "runapi/gpt-5.5" while keeping existing providers available.
- After editing config, run `openclaw models status` and confirm `runapi/gpt-5.5` appears.
- If RUNAPI_API_KEY is missing, ask me to set it before starting OpenClaw.
Sign up at https://runapi.ai to get your API key.Gli agenti OpenClaw usano quattro tipi di tool: chat per LLM, image_generate, video_generate e music_generate. Un provider che copre solo LLM lascia tre tool non configurati. Un provider che copre solo le immagini lascia comunque due lacune. RunAPI è l'unico provider con chiave singola che riempie tutti e quattro i slot con oltre 113 modelli, così configuri un baseUrl e una chiave API invece di gestire le credenziali per quattro servizi separati.
Claude, GPT, Gemini, DeepSeek e altri tramite l'endpoint /v1/chat/completions compatibile con OpenAI. Risposte in streaming o output sincrono.
Flux Kontext, Nano Banana, GPT Image, Imagen 4, Seedream, Ideogram e altri. Text-to-image, image-to-image, modifica, remix, upscaling e rimozione dello sfondo.
Kling, Veo, Seedance, Hailuo, Wan, Runway e Luma. Text-to-video, image-to-video e modifica video con polling asincrono dei task.
Suno v4, v4.5, v4.5-plus, v5 e v5.5 tramite API diretta. Modalità custom, extend, remix e generazione dei testi senza bridge di terze parti.
I tutorial di OpenClaw mostrano sviluppatori che usano Replicate per le immagini (1 dollaro per 28 generazioni), un provider LLM separato e bridge per la musica. Ogni provider significa una chiave API separata, un dashboard di fatturazione separato e una modalità di errore separata. RunAPI concentra tutto questo in un unico punto di integrazione.
Configura RunAPI una sola volta in OpenClaw e tutti e quattro i tipi di tool funzionano: chat, image_generate, video_generate e music_generate. Nessuna skill aggiuntiva da installare, nessun plugin ComfyUI, nessun bridge di terze parti per Suno.
Gli sviluppatori che eseguono agenti OpenClaw hanno ridotto le spese API mensili da 1.000 a 1 dollaro instradando i task di routine verso modelli più economici. Il catalogo di oltre 113 modelli di RunAPI rende questa strategia disponibile su tutte le quattro modalità.
OpenClaw supporta già provider personalizzati compatibili con OpenAI. Punta baseUrl su https://runapi.ai/v1, imposta la chiave API e ogni modello nel catalogo RunAPI diventa disponibile senza codice skill personalizzato.
Nessun minimo mensile, nessun credito con scadenza, nessun piano a livelli. Paghi per ciò che il tuo agente OpenClaw genera effettivamente. Aggiungi crediti quando ne hai bisogno, smetti di spendere quando non li usi.
| Esigenza | Scelta ottimale | Perché |
|---|---|---|
| Solo chat LLM, nessuna generazione media | OpenAI o RunAPI | Entrambi funzionano come provider compatibili con OpenAI. RunAPI aggiunge varietà di modelli e opzioni a costo inferiore. |
| Generazione immagini negli agenti OpenClaw | RunAPI | Oltre 30 modelli di immagini tramite un solo endpoint. Nessuna installazione di skill aggiuntiva né setup ComfyUI richiesto. |
| Generazione video negli agenti OpenClaw | RunAPI | Oltre 25 modelli video tra cui Kling, Veo e Seedance. Nessun altro provider con chiave singola copre il video con questa profondità. |
| Generazione musicale negli agenti OpenClaw | RunAPI | Accesso diretto all'API Suno senza bridge di terze parti. Gli altri provider non offrono la generazione musicale. |
| Tutte e quattro le modalità con una sola chiave | RunAPI | L'unico provider che copre LLM, immagini, video e musica tramite una sola chiave API e un solo account di fatturazione. |
| Generazione immagini al costo più basso possibile | Runware o RunAPI | Runware offre 1.670 immagini per dollaro. RunAPI compete sull'ampiezza: immagini più video, musica e LLM in una sola chiave. |
| Dimensione | RunAPI | OpenAI | fal.ai | Replicate | OpenRouter |
|---|---|---|---|---|---|
| Modelli LLM | 20+ modelli: Claude, GPT, Gemini, DeepSeek. Endpoint compatibile con OpenAI. | Solo modelli GPT. API nativa. | Nessun modello LLM. Solo immagini e video. | Alcuni modelli LLM. Non compatibile con OpenAI. | 100+ modelli LLM. Compatibile con OpenAI. Nessuna generazione media. |
| Modelli di immagini | 30+ modelli: Flux, Nano Banana, GPT Image, Imagen 4, Seedream, Ideogram, Recraft. | Solo GPT Image. | 20+ modelli: Flux, Stable Diffusion e modelli della community. | Ampia libreria di modelli. 1 dollaro per 28 immagini su alcuni modelli. | Nessuna generazione immagini. |
| Modelli video | 25+ modelli: Kling, Veo, Seedance, Hailuo, Wan, Runway, Luma. | Nessuna generazione video. | Modelli video limitati. | Alcuni modelli video. Costo per generazione più elevato. | Nessuna generazione video. |
| Modelli musicali | Suno da v4 a v5.5. Modalità custom, extend, remix, testi. | Nessuna generazione musicale. | Nessuna generazione musicale. | Nessuna generazione musicale. | Nessuna generazione musicale. |
| Modello di pricing | Pay-as-you-go. Nessun abbonamento. Nessun credito con scadenza. | Pay-as-you-go. Costo per chiamata più elevato sulla maggior parte dei modelli. | Pay-as-you-go. Prezzi competitivi per immagini a circa 4 centesimi per immagine. | Pagamento per secondo di calcolo. I costi variano ampiamente per modello. | Pay-as-you-go. Solo LLM. |
| Compatibile con OpenAI | Sì. /v1/chat/completions funziona con OpenClaw immediatamente. | Sì. API nativa OpenAI. | No. REST API personalizzata. | No. REST API personalizzata. | Sì. /v1/chat/completions. Solo LLM. |
| Livello gratuito | Registrazione gratuita. Pay-as-you-go dalla prima chiamata. | Livello gratuito con crediti limitati per i nuovi account. | Livello gratuito con crediti mensili limitati. | Livello gratuito con secondi di calcolo limitati. | Livello gratuito con crediti limitati su modelli selezionati. |
Una demo funzionante non è un deployment in produzione. Questi quattro controlli prevengono le modalità di errore comuni che gli sviluppatori OpenClaw incontrano dopo la prima settimana: spese impreviste, chiamate tool non funzionanti, gestione degli errori mancante e perdite di credenziali.
Imposta RUNAPI_API_KEY nel profilo della tua shell o nei segreti CI. Non incollare mai le chiavi API nella finestra di contesto di OpenClaw né eseguirne il commit nel controllo versione. La configurazione di OpenClaw legge ${RUNAPI_API_KEY} a runtime.
Usa modelli più economici come gpt-5.4-mini per la revisione del codice di routine e riserva i modelli premium per il ragionamento complesso. La stessa strategia si applica alle immagini: usa modelli fast per le bozze, modelli pro per l'output finale.
Un 402 significa crediti insufficienti. Un 429 significa limite di frequenza. Entrambi sono recuperabili. Configura OpenClaw per riprovare al 429 con backoff e inviare un avviso al 402 in modo da poter aggiungere crediti prima che l'agente si blocchi.
Usa il dashboard RunAPI per monitorare la spesa giornaliera per modello ed endpoint. Imposta avvisi di budget prima di una sessione di agente a lunga esecuzione. Rivedi il riepilogo di utilizzo settimanalmente per trovare opportunità di ottimizzazione dei costi.
Agenti OpenClaw che generano mockup UI, foto di prodotto o diagrammi insieme al codice. Instrada le chiamate tool image_generate a Flux Kontext, Nano Banana o GPT Image tramite RunAPI.
Guida alla generazione immaginiWorkflow OpenClaw che producono video di marketing, clip social o musica di sottofondo per presentazioni. Instrada video_generate a Kling o Veo e music_generate a Suno.
Confronto API videoAgenti che passano tra modelli economici e premium in base alla complessità del task. Usa gpt-5.4-mini per i task semplici, gpt-5.5 per il ragionamento complesso e flux-kontext-pro per le immagini, tutto con una sola chiave API.
Visualizza i prezziQuesti sono i corpi di richiesta effettivi che il tuo agente OpenClaw invia tramite RunAPI. Ogni modalità usa un endpoint diverso ma la stessa chiave API e autenticazione. Cambia i modelli modificando il campo model.
{
"model": "gpt-5.5",
"messages": [
{
"role": "user",
"content": "Summarize this pull request"
}
],
"stream": true
}{
"model": "flux-kontext-pro",
"prompt": "Product photo of wireless headphones on marble surface"
}{
"model": "kling-3.0",
"prompt": "Drone flyover of a coastal city at golden hour",
"duration": "5"
}{
"model": "suno-v4.5",
"prompt": "Upbeat jazz piano loop, 120 BPM, no vocals",
"duration": 30
}Crea un account RunAPI gratuito, genera una chiave API dal dashboard ed esportala come RUNAPI_API_KEY nel profilo della tua shell. OpenClaw legge la chiave dall'ambiente all'avvio.
Apri la configurazione di OpenClaw e aggiungi un provider personalizzato con baseUrl https://runapi.ai/v1, api impostato su openai-completions e l'ID del modello che vuoi usare, ad esempio gpt-5.5. Imposta models.mode su merge per mantenere i provider esistenti.
Esegui openclaw models status per confermare che il modello RunAPI appaia. Passa ad esso con openclaw models set runapi/gpt-5.5, poi avvia una sessione OpenClaw. I tool per immagini, video e musica funzionano con la stessa chiave API.
Gli altri provider richiedono skill GitHub personalizzate, script bash o plugin ComfyUI per la generazione media in OpenClaw. RunAPI funziona tramite l'interfaccia provider standard compatibile con OpenAI senza installazioni aggiuntive.
I tutorial di generazione musicale con OpenClaw mostrano architetture multi-hop: da Telegram a OpenClaw a un bridge service fino a Suno. RunAPI fornisce Suno da v4 a v5.5 direttamente, eliminando il bridge e le sue modalità di errore.
Il catalogo di RunAPI ti permette di scegliere il punto costo-performance per ogni task. Usa gpt-5.4-nano per la classificazione semplice, gpt-5.5 per il ragionamento complesso, flux-kontext-pro per le immagini in produzione e suno-v4 per la musica in bozza.
I task di immagini, video e musica condividono lo stesso lifecycle crea-polling-webhook. Il tuo agente OpenClaw crea un task, esegue il polling fino al completamento e riceve l'URL dell'output. Passare da Kling a Veo cambia il campo model, non il codice di integrazione.
I costi di generazione immagini variano da 1 dollaro per 28 immagini su Replicate a 1.670 immagini per dollaro su Runware. I costi LLM dipendono dal modello e dal numero di token. RunAPI usa prezzi pay-as-you-go su tutte le modalità senza abbonamenti, senza crediti con scadenza e senza spesa minima. Consulta la pagina prezzi aggiornata per le tariffe per chiamata correnti.
I dati sui prezzi provengono dalla documentazione dei provider, dalle pagine pubbliche dei prezzi API e dai report della community degli sviluppatori a giugno 2026. I costi cambiano frequentemente. Verifica sempre i prezzi correnti sulla pagina prezzi del provider prima del deployment in produzione.
Sì. RunAPI fornisce oltre 113 modelli su modalità LLM, immagini, video e musica tramite una sola chiave API. Configura RunAPI come provider personalizzato compatibile con OpenAI in OpenClaw e tutti e quattro i tipi di tool funzionano senza skill o plugin aggiuntivi.
RunAPI offre gli stessi modelli OpenAI più oltre 90 alternative a prezzi competitivi. Il solo cambio di modello può ridurre significativamente i costi. Usa gpt-5.4-mini per i task di routine e riserva i modelli premium per il lavoro complesso.
Non con RunAPI. Gli altri provider richiedono skill GitHub o plugin ComfyUI. RunAPI funziona tramite l'endpoint standard compatibile con OpenAI, quindi il tool image_generate integrato di OpenClaw si connette senza setup aggiuntivo.
RunAPI fornisce accesso API diretto a Suno da v4 a v5.5. Il tuo agente OpenClaw chiama il tool music_generate, che invia una richiesta all'endpoint Suno di RunAPI. Nessun bridge di terze parti né account Suno separato necessario.
Sì. Imposta models.mode su merge nella configurazione di OpenClaw. RunAPI diventa un provider accanto a quelli esistenti. Puoi impostare RunAPI come modello primario o mantenerlo come fallback per modalità specifiche.
RunAPI restituisce un codice di stato 402. Il tuo agente OpenClaw riceve un errore di crediti insufficienti e smette di generare. Aggiungi crediti tramite il dashboard RunAPI e l'agente riprende immediatamente. Nessun abbonamento richiesto.
Configura RunAPI in OpenClaw una volta sola e il tuo agente di codifica AI ottiene accesso a chat LLM, generazione immagini AI, generazione video AI e creazione musicale tramite una singola chiave API e un solo account di fatturazione.