> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mindsee.app/llms.txt
> Use this file to discover all available pages before exploring further.

# GPT Image 2.5 Sunburst

| 项目 | 说明 |
| - | - |
| 模型 ID | `gpt-image-2.5-sunburst` |
| 能力 | 文生图、图片编辑 |
| 接口 | [`POST /v1/images/generations`](/api-reference/images-generations) |

## 参数

| 参数 | 类型 | 必填 | 可选值 | 默认值 | 说明 |
| - | - | - | - | - | - |
| `model` | string | 是 | `gpt-image-2.5-sunburst` | — | 模型 ID |
| `prompt` | string | 是 | 1 到 32000 个字符 | — | 生图提示词 |
| `image` | string\[] | 否 | 最多 8 张 | — | 待编辑图片的 base64，必须带 data URL 前缀，如 `data:image/png;base64,`，单张解码后不超过 20MB。不为空时为图片编辑 |
| `resolution` | string | 是 | `auto`、`1K` | — | 输出分辨率档位 |
| `ratio` | string | 是 | `auto`、`1:1`、`3:4`、`4:3`、`16:9`、`9:16`、`2:3`、`3:2`、`21:9` | — | 输出宽高比 |
| `quality` | string | 否 | `auto`、`low`、`medium`、`high`、`xhigh`、`max` | `auto` | 输出质量 |
| `output_format` | string | 否 | `png`、`jpeg`、`webp` | `png` | 输出格式 |
| `background` | string | 否 | `auto`、`opaque`、`transparent` | `auto` | 背景模式 |

## 组合限制

* `resolution` 与 `ratio` 要么都是 `auto`，要么都不是。`resolution=1K` 时必须指定具体比例。
* `background=transparent` 时，`output_format` 只能是 `png` 或 `webp`。

## 请求示例

<CodeGroup>
  ```bash 文生图 theme={null}
  curl https://openapi.mindsee.app/v1/images/generations \
    --max-time 330 \
    -H "Authorization: Bearer $MINDSEE_API_KEY" \
    -H "Content-Type: application/json" \
    -d '{
      "model": "gpt-image-2.5-sunburst",
      "prompt": "一只橘猫坐在窗台上看雨，水彩风格",
      "resolution": "1K",
      "ratio": "3:4",
      "quality": "max"
    }'
  ```

  ```bash 图片编辑 theme={null}
  jq -n --rawfile image <(base64 < input.png | tr -d '\n') '{
    "model": "gpt-image-2.5-sunburst",
    "prompt": "把背景换成海边日落",
    "image": ["data:image/png;base64," + $image],
    "resolution": "auto",
    "ratio": "auto"
  }' | curl https://openapi.mindsee.app/v1/images/generations \
    --max-time 330 \
    -H "Authorization: Bearer $MINDSEE_API_KEY" \
    -H "Content-Type: application/json" \
    -d @-
  ```
</CodeGroup>

## 响应示例

```json theme={null}
{
  "created": 1767225600,
  "data": [
    {
      "b64_json": "iVBORw0KGgoAAAANSUhEUgAA..."
    }
  ]
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.