---
title: "Usa Ideogram V3 en OpenClaw con RunAPI — Guía de API de imagen"
url: "https://runapi.ai/pt-BR/openclaw-ideogram-v3.md"
canonical: "https://runapi.ai/pt-BR/openclaw-ideogram-v3"
locale: "pt-BR"
model: "ideogram-v3"
---

# Usa Ideogram V3 en OpenClaw.

Ideogram V3 genera imágenes con renderizado tipográfico líder en la industria — tipografía legible en pósters, logotipos y carteles con la que otros modelos de imagen tienen dificultades. Ofrece tres endpoints (text_to_image, edit_image, remix_image) y un nivel de velocidad turbo que reduce el tiempo de generación a la mitad con menor coste. Los agentes OpenClaw lo llaman a través de la misma clave RunAPI y endpoint /v1 usados para chat, sin habilidades adicionales que instalar.

## 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": "ideogram-v3-text-to-image",
    "prompt": "A minimalist cafe menu poster, cream background, the text FRESH BREWED written in elegant serif font at the top, three coffee cup illustrations below, warm earth tones",
    "style": "design",
    "aspect_ratio": "3:4",
    "rendering_speed": "balanced"
  }'

```

### Response

```json
{
  "task_id": "tsk_abc123",
  "status": "pending",
  "model": "ideogram-v3-text-to-image"
}

```

## How it works

1. **Configura RunAPI** — Establece la variable de entorno RUNAPI_API_KEY en tu perfil de shell. Si RunAPI ya está configurado en OpenClaw para chat, la misma clave funciona para Ideogram V3 — no se necesita configuración adicional.
2. **Llama a Ideogram V3** — Envía una solicitud POST al endpoint text_to_image con model establecido en ideogram-v3-text-to-image. Incluye tu prompt con cualquier texto que desees renderizar en la imagen. Establece style en design para trabajo de pósters y logotipos, o realistic para salida fotográfica. Usa rendering_speed turbo para resultados más rápidos a menor coste.
3. **Obtén el resultado** — La API devuelve un task_id inmediatamente. Consulta el endpoint de estado de la tarea hasta que el estado cambie a completed, luego recupera la URL de la imagen de salida de la respuesta. Solicita hasta 4 imágenes por llamada con output_count.

## Parameters

| Parameter | Type | Description |
|-----------|------|-------------|
| `model` | `string` | Obligatorio. ideogram-v3-text-to-image, ideogram-v3-edit o ideogram-v3-remix. |
| `prompt` | `string` | Descripción textual de la imagen deseada. Incluye el texto específico que deseas renderizar. |
| `style` | `string` | Opcional. auto, general, realistic o design. Usa design para pósters y logotipos. |
| `rendering_speed` | `string` | Opcional. turbo (más rápido, menor coste), balanced (predeterminado) o quality (mayor detalle). |
| `aspect_ratio` | `string` | Opcional. 1:1, 3:4, 9:16, 4:3 o 16:9. |
| `output_count` | `integer` | Opcional. Número de imágenes a generar por solicitud. De 1 a 4. |
| `source_image_url` | `string` | Obligatorio para los endpoints edit y remix. URL de la imagen fuente. |

## FAQ

### ¿Cómo maneja Ideogram V3 el texto en imágenes comparado con otros modelos?

Ideogram V3 está optimizado específicamente para el renderizado tipográfico. Puede producir texto multilínea legible, encabezados estilizados y letras con calidad de logotipo que modelos como Flux o Imagen suelen distorsionar. Si tu caso de uso requiere texto preciso en pósters, carteles o etiquetas de producto, Ideogram V3 es la opción más sólida del catálogo de RunAPI.

### ¿Cuál es la diferencia entre las velocidades de renderizado turbo, balanced y quality?

Turbo genera lo más rápido a aproximadamente la mitad del coste de balanced. Quality produce la salida con mayor detalle pero tarda más. Balanced es el punto medio predeterminado. Los tres niveles usan el mismo modelo Ideogram V3 subyacente — la diferencia es el tiempo de cómputo y la fidelidad, no la versión del modelo.

### ¿Puedo editar o remixar imágenes existentes con Ideogram V3?

Sí. Usa el endpoint edit_image con ideogram-v3-edit para modificar una imagen fuente guiada por un prompt de texto. Usa el endpoint remix_image con ideogram-v3-remix para transferir el estilo de una imagen fuente a una nueva composición. Ambos requieren source_image_url como parámetro.

### ¿Cómo funciona la facturación por imagen con output_count?

Cada imagen generada se factura por separado. Si estableces output_count en 4, se te cobra por 4 imágenes. La tarifa por imagen depende de tu configuración de rendering_speed — turbo cuesta aproximadamente la mitad que balanced. Consulta la página de precios de RunAPI para las tarifas actuales.

### ¿Ideogram V3 es asíncrono o síncrono?

Asíncrono. La API devuelve un task_id inmediatamente. Consulta el endpoint de estado de la tarea hasta que se complete. Los SDK y la CLI de RunAPI gestionan el polling automáticamente. Las generaciones fallidas no se cobran.


## Links

- [Guía de configuración de OpenClaw →](https://runapi.ai/pt-BR/openclaw)
- [Modelos de Ideogram V3 →](https://runapi.ai/pt-BR/models/ideogram-v3)
- [Model catalog](https://runapi.ai/pt-BR/models)
- [API docs](https://runapi.ai/pt-BR/docs)