---
title: "Use Topaz no OpenClaw via RunAPI — Guia de API de Upscaling de Imagem com IA"
url: "https://runapi.ai/pt-BR/openclaw-topaz.md"
canonical: "https://runapi.ai/pt-BR/openclaw-topaz"
locale: "pt-BR"
model: "topaz"
---

# Use Topaz no OpenClaw.

Topaz da Topaz Labs faz upscale de imagens até 8x de resolução usando redes neurais que recuperam detalhes sem artefatos. Agentes OpenClaw o chamam pelo mesmo endpoint RunAPI e API key usados para chat e geração de imagem — envie uma URL de imagem, escolha um fator de escala e faça polling pelo resultado aprimorado.

## API example

```bash
curl -X POST https://runapi.ai/api/v1/topaz/upscale_image \
  -H "Authorization: Bearer $RUNAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "topaz-upscale-image",
    "image_url": "https://example.com/photo.jpg",
    "scale": 4
  }'

```

### Response

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

```

## How it works

1. **Configure RunAPI** — Se você ainda não configurou RunAPI no OpenClaw, siga o guia de configuração do OpenClaw. Defina a variável de ambiente RUNAPI_API_KEY e adicione RunAPI como provider compatível com OpenAI com baseUrl https://runapi.ai/v1.
2. **Chame Topaz upscale_image** — Envie uma requisição POST ao endpoint upscale_image com model definido como topaz-upscale-image, o image_url de origem e um fator de escala opcional de 2, 4 ou 8. A mesma key RunAPI gerencia autenticação.
3. **Faça polling pelo resultado** — O endpoint retorna um task_id com status pending. Faça polling do endpoint de status da tarefa até o status mudar para completed, depois recupere a URL da imagem com upscale na resposta. SDKs RunAPI e o CLI fazem polling automaticamente.

## Parameters

| Parameter | Type | Description |
|-----------|------|-------------|
| `model` | `string` | Obrigatório. topaz-upscale-image ou topaz-upscale-video. |
| `image_url` | `string` | URL da imagem para fazer upscale. |
| `scale` | `integer` | Opcional. Fator de upscale: 2, 4 ou 8. Padrão 2. |
| `callback_url` | `string` | Opcional. URL de webhook para notificação de conclusão assíncrona. |

## FAQ

### Posso usar Topaz no OpenClaw?

Sim. Configure RunAPI como provider compatível com OpenAI no OpenClaw, depois instrua o agente a chamar o endpoint Topaz upscale_image. A mesma RUNAPI_API_KEY usada para chat e geração de imagem também gerencia requisições de upscaling.

### Preciso de uma API key separada para Topaz?

Não. A mesma RUNAPI_API_KEY que alimenta chat, geração de imagem e outros modelos também funciona para upscaling Topaz. Todos os modelos RunAPI compartilham uma API key e um saldo de créditos.

### O upscaling Topaz é assíncrono ou síncrono?

O upscaling Topaz é assíncrono. O endpoint retorna um task_id imediatamente. Seu agente OpenClaw faz polling do endpoint de status da tarefa até a imagem com upscale estar pronta. SDKs RunAPI e o CLI fazem polling automaticamente.

### Quanto custa o upscaling Topaz?

Topaz usa precificação pay-as-you-go por tarefa pelo RunAPI. Verifique a página de preços do RunAPI para taxas atuais. Não há assinatura mensal ou gasto mínimo.


## Links

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