---
title: "Z Image in OpenClaw via RunAPI verwenden — Bild-API-Anleitung"
url: "https://runapi.ai/de/openclaw-z-image.md"
canonical: "https://runapi.ai/de/openclaw-z-image"
locale: "de"
model: "z-image"
---

# 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.

## API example

```bash
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"
  }'

```

### Response

```json
{
  "task_id": "tsk_abc123",
  "status": "pending",
  "model": "z-image"
}

```

## How it works

1. **RunAPI konfigurieren** — Den RunAPI-API-Key als Umgebungsvariable setzen. Wenn RunAPI bereits in OpenClaw fuer Chat konfiguriert ist, funktioniert derselbe Key auch fuer Bildgenerierung.
2. **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.
3. **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.

## Parameters

| Parameter | Type | Description |
|-----------|------|-------------|
| `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. |

## FAQ

### Kann ich Z Image in OpenClaw verwenden?

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.

### Brauche ich einen separaten API-Key fuer Z Image?

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.

### Ist Z Image asynchron oder synchron?

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.

### Was kostet Z Image?

Z Image wird nutzungsbasiert pro Task abgerechnet. Aktuelle Preise auf der RunAPI-Preisseite. Kein monatliches Abonnement oder Mindestbetrag.


## Links

- [OpenClaw Einrichtungsanleitung →](https://runapi.ai/de/openclaw)
- [Z Image Modelle →](https://runapi.ai/de/models/z-image)
- [Model catalog](https://runapi.ai/de/models)
- [API docs](https://runapi.ai/de/docs)