# CherryImage 1.0 Pro

> 最高 2K 分辨率的高保真文生图，以及基于参考图的图像编辑。

> Sakuranbo AI 目前处于预览阶段。

- 模型 ID: `sakuranbo/cherryimage-1.0-pro`
- 提供方: Sakuranbo AI
- 模态: 图像
- 任务: 文生图和图像编辑
- 上游状态: GA（上游）
- 最后更新: 2026-10-28
- HTML 页面: https://sakuranbo.ai/zh/models/sakuranbo/cherryimage-1.0-pro/
- llms.txt: https://sakuranbo.ai/zh/models/sakuranbo/cherryimage-1.0-pro/llms.txt

## 说明

CherryImage 1.0 Pro 可根据最多 5,000 字符的提示词生成图像，并使用 1 到 10 张参考图编辑图像。可选择 1K、1.5K 或 2K 输出及宽高比，按分辨率以每张计价。

## 能力

- 输入: 文本和图像
- 输出: 图像
- 分辨率: 1k, 1.5k, 2k
- 宽高比: auto, 1:1, 4:3, 3:4, 16:9, 9:16, 3:2, 2:3, 21:9
- 流式输出: 否
- 异步任务: 是

## 参数

| 名称 | 类型 | 必填 | 默认值 | 约束 | 说明 |
| --- | --- | --- | --- | --- | --- |
| `prompt` | string | 是 |  | 最多 5,000 个字符 | 要生成的图像或要应用的编辑的文字描述。 |
| `images` | url[] | 否 |  | 最多 10 项 | 用于编辑的参考图（1 到 10 张）。在 /v1/images/edits 中为必填。 |
| `resolution` | enum | 否 | `2k` | 可选值：1k, 1.5k, 2k | 输出分辨率，决定每张图片的价格。 |
| `n` | integer | 否 | `1` | 1 至 100 | 要生成的图像数量（1 到 100）。价格为每张图片的价格乘以该值。 |
| `aspect_ratio` | enum | 否 | `auto` | 可选值：auto, 1:1, 4:3, 3:4, 16:9, 9:16, 3:2, 2:3, 21:9 | 输出图像的宽高比。 |
| `output_format` | enum | 否 | `jpeg` | 可选值：jpeg, png | 图像文件格式。 |

## 价格

价格以 USD 计价，已包含我们的加价。失败、已取消、已过期以及被内容政策拒绝的运行不会计费。对于对话，模型开始生成输出（包括推理输出）后，即使流中断或连接被关闭，也会对已生成的输出计费。

| 项目 | 单位 | 条件 | 价格 |
| --- | --- | --- | --- |
| 输出图像 | 每张 | resolution: 1k | $0.045 |
| 输出图像 | 每张 | resolution: 1.5k | $0.05 |
| 输出图像 | 每张 | resolution: 2k | $0.09 |

### 价格示例

示例按标价计算。最终费用由服务器根据实际用量计算。

- 默认设置一次运行：$0.09（1 张，2K）
- 1 张 1K 图像: $0.045
- 1 张 1.5K 图像: $0.05
- 1 张 2K 图像: $0.09
- 100 张 2K 图像: $9.00

## API

### 预估价格

POST /v1/estimate 接收 JSON 请求体（{ model, input }），在运行前返回该输入的价格。该端点无需 API 密钥。

```bash
curl -X POST "https://api.sakuranbo.ai/v1/estimate" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "sakuranbo/cherryimage-1.0-pro",
  "input": {
    "prompt": "A matte ceramic coffee mug on a walnut desk, soft morning light, shallow depth of field",
    "resolution": "2k",
    "aspect_ratio": "4:3"
  }
}'
```

### 生成

向 /v1/images/generations 发送生成请求。下方请求使用了该模型在目录中的示例输入。

```bash
curl -X POST "https://api.sakuranbo.ai/v1/images/generations" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $SAKURANBO_API_KEY" \
  -d '{
  "model": "sakuranbo/cherryimage-1.0-pro",
  "prompt": "A matte ceramic coffee mug on a walnut desk, soft morning light, shallow depth of field",
  "resolution": "2k",
  "aspect_ratio": "4:3"
}'
```

[阅读图像指南](https://sakuranbo.ai/zh/docs/images/)

## 数据政策

- 生成的文件保存 7 天，之后删除。
- 不存储提示词，只保留请求的元数据。
- 您的请求会转发给运行该模型的上游提供方。

## 相关模型

- [Cherry 1.0 Pro](https://sakuranbo.ai/zh/models/sakuranbo/cherry-1.0-pro.md): 根据文本或图像生成 2 至 30 秒、1080p、2K 或 4K 的带音频视频。
- [CherryText 1.0 Flash](https://sakuranbo.ai/zh/models/sakuranbo/cherrytext-1.0-flash.md): 支持 100 万 token 上下文、工具调用和推理的高速、低成本语言模型。

来源：https://sakuranbo.ai/zh/models/sakuranbo/cherryimage-1.0-pro/