Z Image in OpenClaw verwenden.
Z Image ist Alibabas schnelles Bildgenerierungsmodell mit zweisprachigem Textrendering in Chinesisch und Englisch. OpenClaw-Agenten rufen es ueber denselben RunAPI-Endpunkt und API-Key wie fuer Chat auf — keine zusaetzlichen Skills oder Provider-Konten 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.
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 OpenClaw in drei Schritten verwenden
RunAPI konfigurieren
Den RunAPI-API-Key als Umgebungsvariable setzen. Wenn RunAPI bereits in OpenClaw fuer Chat konfiguriert ist, funktioniert derselbe Key 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 auf OpenClaw?
Z Image ist das geschwindigkeitsoptimierte Bildmodell, das Nutzer als "erstaunlich" für seine Subsekunden-Generierung und ultrarealistischen Output auf Consumer-Hardware bezeichnen. Es läuft auf Apache 2.0 Open Source, rendert zweisprachigen Text auf Chinesisch und Englisch und erfasst subtile Gesichtsdetails, die andere schnelle Modelle verpassen. Bei ca. 0,004 $ pro Bild über RunAPI ist es eine der günstigsten verfügbaren Optionen. OpenClaw-Agenten rufen es mit demselben API-Key auf, der für Chat verwendet wird.
Z Image Anwendungsfälle
Konzeptexploration und schnelles Prototyping
Dutzende visuelle Konzepte in Sekunden zu Bruchteilen eines Cents pro Stück generieren – ideal für die Exploration von Richtungen, bevor man sich für ein teureres Modell für die Endausgabe entscheidet.
Zweisprachige Marketingkampagnen
Marketing-Visuals mit korrekt gerendertem Chinesisch und Englisch in einem einzigen Bild erstellen – nützlich für grenzüberschreitenden E-Commerce und mehrsprachige Social Media.
Mode- und Produktfotografie-Mockups
Realistische Produktfotografie-Mockups mit genauen Materialtexturen und Beleuchtung generieren – schnell genug, um Kompositionen in Echtzeit zu iterieren.
Z Image + OpenClaw — Fragen
Ja. Wenn RunAPI als Provider in OpenClaw konfiguriert ist, verarbeiten derselbe API-Key und derselbe Endpunkt 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.
OpenClaw Grundeinrichtung
Noch nicht eingerichtet? Mit der RunAPI-Einrichtungsanleitung fuer OpenClaw starten.
OpenClaw Einrichtungsanleitung →Z Image Modellkatalog
Alle Z Image-Varianten, Preise und API-Dokumentation ansehen.
Z Image Modelle →Z Image in OpenClaw noch heute ausprobieren.
Einen kostenlosen RunAPI-Key holen, den Prompt in OpenClaw einfuegen und Bilder mit zweisprachigem Textrendering generieren.