# 生图怎么用 (/docs/models/images)

按张生成一张图。`model` 用对照表里的生图 ID，见 [概览](/docs/models)。配图（带参考图）见 [生图配图](/docs/models/reference)。

```bash
export BASE=https://www.dexbuddy.app
export DEX_API_KEY='dbh_sk_…'

curl -sS "$BASE/v1/images/generate" \
  -H "Authorization: Bearer $DEX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "image-standard",
    "prompt": "一只站在窗台上看雨的猫",
    "aspect_ratio": "3:4"
  }'
```

现网还有 `image-pro`。两把都是 `kind=image`，按张扣费。

## 请求 [#请求]

`POST /v1/images/generate`

| 字段 | 必填 | 说明 |
|------|------|------|
| `model` | 是 | 生图渠道 Model ID。不回落默认文案渠道 |
| `prompt` | 是 | 提示词 |
| `aspect_ratio` | 否 | 宽高比，例如 `1:1`、`3:4` |
| `fileIds` | 否 | 参考图的网关文件 id，见配图页 |

## 成功 [#成功]

HTTP 200：

| 字段 | 说明 |
|------|------|
| `downloadUrl` | 签名下载地址 |
| `mediaType` | 例如 `image/png` |
| `expiresAt` | **签名链过期**，不是对象保存 90 天 |
| `model` | 渠道 Model ID |

**无**顶层 `billing`。

## HTTP 与插件字段不要抄错 [#http-与插件字段不要抄错]

| | HTTP `/v1/images/generate` | 插件 `images.generate` |
|--|----------------------------|------------------------|
| 参考图 | `fileIds`（网关文件 id） | `input.input_images`（本机绝对路径） |
| 结果 | `downloadUrl` | `{ status, output: 本地绝对路径, model }` |

插件路径见 [插件开发 → 模型](/docs/plugins/models)。