Z Image in Hermes Agent verwenden.
Z Image ist Alibabas schnelles Bildgenerierungsmodell mit zweisprachigem Textrendering in Chinesisch und Englisch. Hermes Agent ruft es ueber den RunAPI-Custom-Provider-Endpunkt auf — dieselbe base_url und derselbe API-Key wie fuer Chat, keine zusaetzlichen Plugins oder GPU-Mieten noetig.
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"
}
Z Image in Hermes Agent in drei Schritten verwenden
RunAPI konfigurieren
Den RunAPI-API-Key als Umgebungsvariable setzen. Wenn RunAPI bereits als Custom-Provider in Hermes Agent konfiguriert ist, funktionieren derselbe Key und dieselbe base_url auch fuer Bildgenerierung.
export RUNAPI_API_KEY=runapi_xxx
Z Image aufrufen
Einen POST-Request an den text_to_image-Endpunkt mit model z-image und einem Textprompt senden. Z Image unterstuetzt sowohl chinesische als auch englische Prompts mit praezisem Textrendering.
text_to_image
Ergebnis abrufen
Die API gibt sofort eine task_id zurueck. Den Task-Status-Endpunkt abfragen, bis der Status auf completed wechselt, dann die generierte Bild-URL aus der Antwortausgabe auslesen.
task_id: tsk_abc123
Z Image API-Parameter
| Parameter | Typ | Beschreibung |
|---|---|---|
model |
string |
Erforderlich. z-image verwenden. |
prompt |
string |
Textbeschreibung. Unterstuetzt Chinesisch und Englisch. |
negative_prompt |
string |
Optional. Was im Bild vermieden werden soll. |
size |
string |
Optional. Ausgabeabmessungen, z. B. 1024x1024. |
Was ist Z Image mit Hermes Agent?
Z Image liefert das, was Nutzer als "irrsinnige Geschwindigkeit und Realismus" beschreiben – es generiert fotorealistische Bilder in unter einer Sekunde mit starker Prompt-Treue und genauen Gesichtsdetails. Aufgebaut auf Apache-2.0-Open-Source-Weights ist es sowohl das schnellste als auch das günstigste Bildmodell auf RunAPI bei ca. 0,004 $ pro Bild. Hermes Agent ruft es über denselben Custom-Provider auf, der für Chat verwendet wird.
Z Image Anwendungsfälle
Storyboarding für Film und Animation
Storyboard-Frames mit Subsekunden-Geschwindigkeit generieren und Kompositionen und Kamerawinkel so schnell iterieren, dass man mit kreativen Diskussionen in Echtzeit mithalten kann.
E-Commerce-Produktvisualisierung
Produktlisting-Bilder mit realistischen Materialien und Beleuchtung zu den niedrigsten Kosten pro Bild auf RunAPI generieren – geeignet für hochvolumige KatalogGenerierung.
Bildungsillustrationen
Bildungsdiagramme und Illustrationen mit zweisprachigen Textbeschriftungen erstellen – nützlich für Lehrbücher, Kursmaterialien und Schulungscontent für chinesische und englische Zielgruppen.
Z Image + Hermes Agent — Fragen
Ja. Wenn RunAPI als Custom-Provider in Hermes Agent konfiguriert ist, verarbeiten derselbe API-Key und dieselbe base_url auch Z Image-Requests. Einen POST an den text_to_image-Endpunkt mit model z-image senden.
Nein. Derselbe RUNAPI_API_KEY fuer Chat und andere Modelle funktioniert auch fuer Z Image. Alle RunAPI-Modelle teilen sich einen Key und ein Guthaben.
Z Image ist asynchron. Die API gibt sofort eine task_id zurueck. Den Task-Status-Endpunkt abfragen oder einen Webhook-Callback nutzen, um zu erfahren, wann das Bild fertig ist. RunAPI SDKs uebernehmen das Polling automatisch.
Z Image wird nutzungsbasiert pro Task abgerechnet. Aktuelle Preise auf der RunAPI-Preisseite. Kein monatliches Abonnement oder Mindestbetrag.
Hermes Agent Grundeinrichtung
Noch nicht eingerichtet? Mit der RunAPI-Einrichtungsanleitung fuer Hermes Agent starten.
Hermes Agent Einrichtungsanleitung →Z Image Modellkatalog
Alle Z Image-Varianten, Preise und API-Dokumentation ansehen.
Z Image Modelle →Z Image in Hermes Agent noch heute ausprobieren.
Einen kostenlosen RunAPI-Key holen, den Custom-Provider konfigurieren und Bilder mit zweisprachigem Textrendering generieren.