Usa Z Image in OpenClaw.
Z Image è il modello di generazione rapida di immagini di Alibaba con rendering bilingue del testo in cinese e inglese. Gli agenti OpenClaw lo chiamano tramite lo stesso endpoint RunAPI e API key usati per la chat — senza skill aggiuntive o account provider.
Use the RunAPI text_to_image endpoint to generate an image with Z Image.
Requirements:
- Use the RUNAPI_API_KEY environment variable for authentication.
- Send a POST request to https://runapi.ai/v1/text_to_image.
- Set model to "z-image".
- Write a descriptive prompt for the image you want to generate.
- The response returns a task_id. Poll the task status endpoint until the task completes, then retrieve the image URL from the output.
curl -X POST https://runapi.ai/v1/text_to_image \
-H "Authorization: Bearer $RUNAPI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "z-image",
"prompt": "A neon-lit Tokyo street at night with Japanese shop signs, cinematic lighting, 8K detail"
}'
{
"task_id": "tsk_abc123",
"status": "pending",
"model": "z-image"
}
Usa Z Image in OpenClaw in tre passaggi
Configura RunAPI
Imposta la tua API key RunAPI come variabile d'ambiente. Se hai già configurato RunAPI per la chat in OpenClaw, la stessa key funziona per la generazione di immagini.
export RUNAPI_API_KEY=runapi_xxx
Chiama Z Image
Invia una richiesta POST all'endpoint text_to_image con model impostato su z-image e un prompt di testo. Z Image supporta prompt in cinese e inglese con rendering preciso del testo.
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 generata dall'output della risposta.
task_id: tsk_abc123
Parametri API Z Image
| Parametro | Tipo | Descrizione |
|---|---|---|
model |
string |
Obbligatorio. Usa z-image. |
prompt |
string |
Descrizione testuale. Supporta cinese e inglese. |
negative_prompt |
string |
Facoltativo. Cosa evitare nell'immagine. |
size |
string |
Facoltativo. Dimensioni dell'output, es. 1024x1024. |
Cos'è Z Image su OpenClaw?
Z Image è il modello di immagine ottimizzato per la velocità che gli utenti chiamano "incredibile" per la sua generazione in meno di un secondo e l'output ultra-realistico su hardware consumer. Funziona su open source Apache 2.0, renderizza testo bilingue in cinese e inglese, e cattura dettagli facciali sottili che altri modelli veloci mancano. A circa 0,004 $ per immagine tramite RunAPI, è una delle opzioni più economiche disponibili. Gli agenti OpenClaw lo chiamano con la stessa API key usata per la chat.
Casi d'uso di Z Image
Esplorazione di concetti e prototipazione rapida
Generare decine di concetti visivi in secondi a frazioni di centesimo ciascuno, ideale per esplorare direzioni prima di impegnarsi con un modello più costoso per l'output finale.
Campagne marketing bilingue
Creare visual di marketing con testo in cinese e inglese correttamente renderizzato in una singola immagine, utile per l'e-commerce transfrontaliero e i social media multilingue.
Mockup di fotografia moda e prodotti
Generare mockup di fotografia di prodotti realistici con texture di materiali e illuminazione precise, abbastanza veloce da iterare sulle composizioni in tempo reale.
Domande su Z Image + OpenClaw
Sì. Se hai RunAPI configurato come provider in OpenClaw, la stessa API key e endpoint gestiscono le richieste Z Image. Invia un POST all'endpoint text_to_image con model impostato su z-image.
No. La stessa RUNAPI_API_KEY che usi per la chat e altri modelli funziona anche per Z Image. Tutti i modelli RunAPI condividono una sola key e un saldo crediti.
Z Image è asincrono. L'API restituisce immediatamente un task_id. Esegui il polling dell'endpoint di stato del task o usa un webhook callback per sapere quando l'immagine è pronta. Gli SDK RunAPI gestiscono il polling automaticamente.
Z Image usa prezzi pay-as-you-go con fatturazione per task. Controlla la pagina dei prezzi di RunAPI per la tariffa aggiornata. Non c'è abbonamento mensile o spesa minima.
Configurazione generale di OpenClaw
Non ancora configurato? Inizia con la guida di configurazione RunAPI per OpenClaw.
Guida di configurazione di OpenClaw →Catalogo modelli Z Image
Vedi tutte le varianti, i prezzi e la documentazione API di Z Image.
Modelli Z Image →Prova Z Image in OpenClaw oggi.
Ottieni una API key RunAPI gratuita, incolla il prompt in OpenClaw e inizia a generare immagini con rendering bilingue del testo.