---
title: "Usa Z Image en OpenClaw con RunAPI — Guía de API de imágenes"
url: "https://runapi.ai/es/openclaw-z-image.md"
canonical: "https://runapi.ai/es/openclaw-z-image"
locale: "es"
model: "z-image"
---

# Usa Z Image en OpenClaw.

Z Image es el modelo de generación de imágenes rápido de Alibaba con renderizado de texto bilingüe en chino e inglés. Los agentes de OpenClaw lo llaman a través del mismo endpoint y clave API de RunAPI usados para chat — sin skills adicionales ni cuentas de proveedor.

## 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. **Configura RunAPI** — Establece tu clave API de RunAPI como variable de entorno. Si ya configuraste RunAPI para chat en OpenClaw, la misma clave funciona para generación de imágenes.
2. **Llama a Z Image** — Envía una solicitud POST al endpoint text_to_image con model establecido en z-image y un prompt de texto. Z Image admite prompts en chino e inglés con renderizado de texto preciso.
3. **Obtén el resultado** — La API devuelve un task_id de inmediato. Consulta el endpoint de estado de la tarea hasta que el estado cambie a completado y luego recupera la URL de la imagen generada de la salida de la respuesta.

## Parameters

| Parameter | Type | Description |
|-----------|------|-------------|
| `model` | `string` | Obligatorio. Usa z-image. |
| `prompt` | `string` | Descripción de texto. Admite chino e inglés. |
| `negative_prompt` | `string` | Opcional. Lo que se debe evitar en la imagen. |
| `size` | `string` | Opcional. Dimensiones de salida, ej. 1024x1024. |

## FAQ

### ¿Puedo usar Z Image en OpenClaw?

Sí. Si tienes RunAPI configurado como proveedor en OpenClaw, la misma clave API y endpoint gestionan las solicitudes de Z Image. Envía un POST al endpoint text_to_image con model establecido en z-image.

### ¿Necesito una clave API separada para Z Image?

No. La misma RUNAPI_API_KEY que usas para chat y otros modelos también funciona para Z Image. Todos los modelos de RunAPI comparten una clave y un saldo de créditos.

### ¿Z Image es asíncrono o síncrono?

Z Image es asíncrono. La API devuelve un task_id de inmediato. Consulta el endpoint de estado de la tarea o usa un webhook de callback para saber cuándo está lista la imagen. Los SDKs de RunAPI gestionan el polling automáticamente.

### ¿Cuánto cuesta Z Image?

Z Image usa precios de pago por uso con facturación por tarea. Consulta la página de precios de RunAPI para la tarifa actual. No hay suscripción mensual ni gasto mínimo.


## Links

- [Guía de configuración de OpenClaw →](https://runapi.ai/es/openclaw)
- [Modelos de Z Image →](https://runapi.ai/es/models/z-image)
- [Model catalog](https://runapi.ai/es/models)
- [API docs](https://runapi.ai/es/docs)