---
title: "Use Grok Imagine no Hermes Agent via RunAPI — Guia de API de Imagem e Vídeo"
url: "https://runapi.ai/pt-BR/hermes-grok-imagine.md"
canonical: "https://runapi.ai/pt-BR/hermes-grok-imagine"
locale: "pt-BR"
model: "grok-imagine"
---

# Use Grok Imagine no Hermes Agent.

Grok Imagine é a suíte de geração de imagem e vídeo da xAI — text-to-image, image-to-image, text-to-video e image-to-video. Hermes Agent o chama pelo mesmo provider RunAPI personalizado e API key usados para chat, sem plugins extras para 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": "grok-imagine-text-to-image",
    "prompt": "a robot hand placing a chess piece on a board, dramatic side lighting, slow motion feel"
  }'

```

### Response

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

```

## How it works

1. **Configure RunAPI** — Defina a variável de ambiente RUNAPI_API_KEY no seu perfil de shell. Se o provider custom:runapi já está configurado no Hermes Agent para chat, a mesma key funciona para Grok Imagine — nenhuma configuração adicional necessária.
2. **Chame Grok Imagine** — Envie uma requisição POST ao endpoint text_to_image com model definido como grok-imagine-text-to-image. Inclua seu prompt descrevendo a imagem. Para vídeo, use text_to_video com grok-imagine-text-to-video.
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 ou vídeo de saída na resposta.

## Parameters

| Parameter | Type | Description |
|-----------|------|-------------|
| `model` | `string` | Obrigatório. Ex. grok-imagine-text-to-image, grok-imagine-image-to-video. |
| `prompt` | `string` | Descrição de texto da saída desejada. |
| `image_url` | `string` | URL da imagem de origem para image-to-image ou image-to-video. |
| `aspect_ratio` | `string` | Opcional. Proporção de aspecto de saída, ex. 16:9, 1:1. |

## FAQ

### Posso usar Grok Imagine no Hermes Agent?

Sim. Se RunAPI já está configurado como provider personalizado (custom:runapi) no Hermes Agent, a mesma API key e base_url funcionam para Grok Imagine. Defina model como grok-imagine-text-to-image e chame o endpoint text_to_image.

### Preciso de uma API key separada para Grok Imagine?

Não. A mesma RUNAPI_API_KEY que você usa para chat e outros modelos também funciona para Grok Imagine. Uma key cobre todos os 113+ modelos no catálogo RunAPI.

### Grok Imagine é assíncrono ou síncrono?

Assíncrono. A API retorna um task_id imediatamente. Faça polling do endpoint de status da tarefa até a tarefa completar. SDKs RunAPI e o CLI fazem polling automaticamente.

### Quanto custa Grok Imagine?

Grok Imagine usa faturamento por tarefa pelo RunAPI. Verifique a página de preços do RunAPI para taxas atuais. Gerações com falha não são cobradas.


## Links

- [Guia de configuração do Hermes Agent →](https://runapi.ai/pt-BR/hermes-agent)
- [Modelos Grok Imagine →](https://runapi.ai/pt-BR/models/grok-imagine)
- [Model catalog](https://runapi.ai/pt-BR/models)
- [API docs](https://runapi.ai/pt-BR/docs)