---
title: "Use Seedream no Hermes Agent via RunAPI — Guia de API de Imagem"
url: "https://runapi.ai/pt-BR/hermes-seedream.md"
canonical: "https://runapi.ai/pt-BR/hermes-seedream"
locale: "pt-BR"
model: "seedream"
---

# Use Seedream no Hermes Agent.

Seedream é o modelo de geração de imagens da Bytedance com forte renderização de tipografia e saída de até 4K. Hermes Agent o chama pelo mesmo provider RunAPI personalizado e API key usados para chat — sem plugins extras ou aluguel de GPU.

## API example

```bash
curl -X POST https://runapi.ai/api/v1/task/text_to_image \
  -H "Authorization: Bearer $RUNAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedream-4.5-text-to-image",
    "prompt": "A premium coffee bag on a marble countertop, warm morning light, bold serif text FRESH ROAST, 4K product photography"
  }'

```

### Response

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

```

## How it works

1. **Configure RunAPI** — Se você já configurou RunAPI no Hermes Agent para chat, está pronto. O mesmo provider custom:runapi e RUNAPI_API_KEY gerenciam geração de imagem. Se não, adicione o provider personalizado com base_url https://runapi.ai/v1 e execute hermes doctor.
2. **Chame Seedream** — Envie uma requisição ao endpoint text_to_image com model definido como seedream-4.5-text-to-image. Inclua um prompt de texto descrevendo a imagem. RunAPI retorna um task ID imediatamente.
3. **Obtenha o resultado** — Faça polling do endpoint de status da tarefa com o task ID retornado. Quando o status mudar para completed, a resposta inclui a URL da imagem gerada. SDKs RunAPI fazem polling automaticamente.

## Parameters

| Parameter | Type | Description |
|-----------|------|-------------|
| `model` | `string` | Obrigatório. seedream-4.5-text-to-image, seedream-4.5-edit, seedream-5-lite-text-to-image. |
| `prompt` | `string` | Descrição de texto da imagem desejada. |
| `size` | `string` | Opcional. Dimensões de saída. Suporta até 4K. |
| `image_url` | `string` | Imagem de origem para modo de edição. |

## FAQ

### Posso usar Seedream no Hermes Agent?

Sim. Configure RunAPI como provider personalizado no Hermes Agent com base_url https://runapi.ai/v1, depois chame o endpoint text_to_image com model definido como seedream-4.5-text-to-image. A mesma API key gerencia chat e geração de imagem.

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

Não. A mesma RUNAPI_API_KEY que você configurou para o provider custom:runapi também chama Seedream e todos os outros modelos de imagem no catálogo RunAPI. Uma key, uma conta de faturamento.

### Seedream é assíncrono ou síncrono?

Assíncrono. RunAPI retorna um task ID na primeira chamada. Faça polling do endpoint de status da tarefa até o status ser completed, depois recupere a URL da imagem na resposta. SDKs e o CLI fazem polling automaticamente.

### Quanto custa Seedream?

Seedream usa precificação por geração. 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 Seedream →](https://runapi.ai/pt-BR/models/seedream)
- [Model catalog](https://runapi.ai/pt-BR/models)
- [API docs](https://runapi.ai/pt-BR/docs)