---
title: "在爱马仕 (Hermes Agent) 中通过 RunAPI 使用 Seedream — 图像 API 指南"
url: "https://runapi.ai/zh-CN/hermes-seedream.md"
canonical: "https://runapi.ai/zh-CN/hermes-seedream"
locale: "zh-CN"
model: "seedream"
---

# 在 Hermes Agent 中使用 Seedream。

Seedream 是字节跳动的图像生成模型，具有强大的文字排版渲染能力和高达 4K 的输出。Hermes Agent 通过与聊天相同的 RunAPI custom provider 和 API key 调用它，无需额外插件或 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. **配置 RunAPI** — 如果你已经在 Hermes Agent 中为聊天配置了 RunAPI，则无需额外操作。同一个 custom:runapi provider 和 RUNAPI_API_KEY 也可以处理图像生成。否则，请使用 base_url https://runapi.ai/v1 添加 custom provider，并运行 hermes doctor。
2. **调用 Seedream** — 向 text_to_image 端点发送请求，将 model 设为 seedream-4.5-text-to-image，并附上描述图像的文字 prompt。RunAPI 立即返回任务 ID。
3. **获取结果** — 使用返回的任务 ID 轮询任务状态端点。当状态变为 completed 时，响应中包含生成的图像 URL。RunAPI SDK 会自动处理轮询。

## Parameters

| Parameter | Type | Description |
|-----------|------|-------------|
| `model` | `string` | 必填。seedream-4.5-text-to-image、seedream-4.5-edit、seedream-5-lite-text-to-image。 |
| `prompt` | `string` | 对所需图像的文字描述。 |
| `size` | `string` | 可选。输出尺寸，最高支持 4K。 |
| `image_url` | `string` | 编辑模式的源图像。 |

## FAQ

### 可以在 Hermes Agent 中使用 Seedream 吗？

可以。在 Hermes Agent 中将 RunAPI 配置为 custom provider，设置 base_url 为 https://runapi.ai/v1，然后以 seedream-4.5-text-to-image 为 model 调用 text_to_image 端点。同一个 API key 可以同时处理聊天和图像生成。

### Seedream 需要单独的 API key 吗？

不需要。为 custom:runapi provider 配置的同一个 RUNAPI_API_KEY 也可以调用 Seedream 和 RunAPI 目录中的所有其他图像模型。一个 key，一个计费账户。

### Seedream 是异步还是同步的？

异步。RunAPI 在首次调用时返回任务 ID。轮询任务状态端点，直到状态为 completed，然后从响应中获取图像 URL。SDK 和 CLI 会自动处理轮询。

### Seedream 的价格是多少？

Seedream 按次计费。查看 RunAPI 定价页面获取最新价格。生成失败不收费。


## Links

- [Hermes Agent 配置指南 →](https://runapi.ai/zh-CN/hermes-agent)
- [Seedream 模型 →](https://runapi.ai/zh-CN/models/seedream)
- [Model catalog](https://runapi.ai/zh-CN/models)
- [API docs](https://runapi.ai/zh-CN/docs)