Usa Z Image in Hermes Agent.
Z Image è il modello di generazione rapida di immagini di Alibaba con rendering bilingue del testo in cinese e inglese. Hermes Agent lo chiama tramite l'endpoint RunAPI personalizzato — la stessa base_url e API key che usi per la chat, senza plugin aggiuntivi o noleggio GPU.
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.
- Use the custom:runapi provider configured in your Hermes Agent config.yaml.
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 Hermes Agent in tre passaggi
Configura RunAPI
Imposta la tua API key RunAPI come variabile d'ambiente. Se hai già configurato RunAPI come provider personalizzato in Hermes Agent, la stessa key e base_url funzionano 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 Hermes Agent?
Z Image offre ciò che gli utenti descrivono come "velocità e realismo assurdi" -- genera immagini fotorealistiche in meno di un secondo con forte aderenza al prompt e dettagli facciali precisi. Costruito su pesi open source Apache 2.0, è sia il modello di immagine più veloce che il più economico su RunAPI a circa 0,004 $ per immagine. Hermes Agent lo chiama tramite lo stesso provider personalizzato usato per la chat.
Casi d'uso di Z Image
Storyboarding per cinema e animazione
Generare fotogrammi di storyboard a velocità sub-secondo, iterando su composizioni e angoli di camera abbastanza velocemente da tenere il passo con le discussioni creative in tempo reale.
Visualizzazione di prodotti e-commerce
Generare immagini di listino prodotti con materiali e illuminazione realistici al minor costo per immagine su RunAPI, adatto alla generazione di cataloghi in grande volume.
Illustrazioni educative
Creare diagrammi e illustrazioni educative con etichette di testo bilingue, utili per libri di testo, materiali didattici e contenuto di formazione rivolto a pubblici cinesi e inglesi.
Domande su Z Image + Hermes Agent
Sì. Se hai RunAPI configurato come provider personalizzato in Hermes Agent, la stessa API key e base_url 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 Hermes Agent
Non ancora configurato? Inizia con la guida di configurazione RunAPI per Hermes Agent.
Guida di configurazione di Hermes Agent →Catalogo modelli Z Image
Vedi tutte le varianti, i prezzi e la documentazione API di Z Image.
Modelli Z Image →Prova Z Image in Hermes Agent oggi.
Ottieni una API key RunAPI gratuita, configura il provider personalizzato e inizia a generare immagini con rendering bilingue del testo.