配置 Key（三选一，按优先级）

方式 A：环境变量（推荐）


## 使用

直接跟模型说就行，不需要记命令：

> 画一张：山脊上空的银河，长曝光，不要文字

模型会调用工具，参数由它自动填。你也可以明确指定：

| 参数 | 说明 | 默认 |
|---|---|---|
| `prompt` | **（必填）** 画面描述。详细描述效果远好于堆关键词 | — |
| `model` | 换模型，见下方「模型」 | `doubao-seedream-5-0-pro-260628` |
| `size` | 分辨率档位 `1K`/`2K`/`3K`/`4K`，或具体尺寸如 `1024x1024` | `2K` |
| `n` | 生成几张（1-4） | `1` |
| `watermark` | 是否加水印 | `false` |
| `outputName` | 指定文件名（不含扩展名） | 由提示词+时间生成 |

### 模型

| 模型 ID | 特点 |
|---|---|
| `doubao-seedream-5-0-pro-260628` | 单张精修，质量最高（默认） |
| `doubao-seedream-5-0-260128` | 5.0 标准版 |
| `doubao-seedream-5-0-lite-260128` | 支持 2K/3K/4K 与组图，速度更快 |
| `doubao-seedream-4-5-251128` | 上一代 |
| `doubao-seedream-4-0-250828` | 上一代 |

> **注意**：只有你在火山方舟**开通**过的模型才能调用，否则会报 404。

---

## 配置项

在你 profile 的 `cordis.patch.yml` 中覆盖：

```yaml
- id: ark-image
  name: dsh-ark-image
  config:
    baseUrl: https://ark.cn-beijing.volces.com/api/v3   # API 地址
    model: doubao-seedream-5-0-pro-260628               # 默认模型
    outputDir: generated-images                          # 输出目录（相对工作区）
    timeoutMs: 180000                                    # 单次请求超时（毫秒）
    apiKey: ''                                           # 留空则读 ARK_API_KEY 环境变量

outputDir 可以是相对路径（相对会话工作区）或绝对路径。

dsh-ark-image

安裝

說明文件

配置 Key（三选一，按优先级）