---
title: "Use Z Image no OpenClaw via RunAPI — Guia de API de Imagem"
url: "https://runapi.ai/pt-BR/openclaw-z-image.md"
canonical: "https://runapi.ai/pt-BR/openclaw-z-image"
locale: "pt-BR"
model: "z-image"
---

# Use Z Image no OpenClaw.

Z Image é o modelo de geração de imagens rápido da Alibaba com renderização bilíngue de texto em chinês e inglês. Agentes OpenClaw o chamam pelo mesmo endpoint RunAPI e API key usados para chat — sem skills extras ou contas de provider.

## 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. **Configure RunAPI** — Defina sua API key RunAPI como variável de ambiente. Se você já configurou RunAPI para chat no OpenClaw, a mesma key funciona para geração de imagem.
2. **Chame Z Image** — Envie uma requisição POST ao endpoint text_to_image com model definido como z-image e um prompt de texto. Z Image suporta prompts em chinês e inglês com renderização precisa de texto.
3. **Obtenha o resultado** — A API retorna um task_id imediatamente. Faça polling do endpoint de status da tarefa até o status mudar para completed, depois recupere a URL da imagem gerada na saída da resposta.

## Parameters

| Parameter | Type | Description |
|-----------|------|-------------|
| `model` | `string` | Obrigatório. Use z-image. |
| `prompt` | `string` | Descrição de texto. Suporta chinês e inglês. |
| `negative_prompt` | `string` | Opcional. O que evitar na imagem. |
| `size` | `string` | Opcional. Dimensões de saída, ex. 1024x1024. |

## FAQ

### Posso usar Z Image no OpenClaw?

Sim. Se você tem RunAPI configurado como provider no OpenClaw, a mesma API key e endpoint gerenciam requisições Z Image. Envie um POST ao endpoint text_to_image com model definido como z-image.

### Preciso de uma API key separada para Z Image?

Não. A mesma RUNAPI_API_KEY que você usa para chat e outros modelos também funciona para Z Image. Todos os modelos RunAPI compartilham uma key e um saldo de créditos.

### Z Image é assíncrono ou síncrono?

Z Image é assíncrono. A API retorna um task_id imediatamente. Faça polling do endpoint de status da tarefa ou use um callback webhook para saber quando a imagem está pronta. SDKs RunAPI fazem polling automaticamente.

### Quanto custa Z Image?

Z Image usa precificação pay-as-you-go com faturamento por tarefa. Verifique a página de preços do RunAPI para a taxa atual. Não há assinatura mensal ou gasto mínimo.


## Links

- [Guia de configuração do OpenClaw →](https://runapi.ai/pt-BR/openclaw)
- [Modelos Z Image →](https://runapi.ai/pt-BR/models/z-image)
- [Model catalog](https://runapi.ai/pt-BR/models)
- [API docs](https://runapi.ai/pt-BR/docs)