知梦 API 文档

外观

Markdown · 适合发给 AI

Seedream 5.0 ​

seedream-5.0 是知梦提供的 Seedream 5.0 Pro 图片生成模型，使用 OpenAI Images 兼容接口，支持文生图、单张参考图和多张参考图生成。

快速信息 ​

项目内容
模型 IDseedream-5.0
单价¥0.12 / 张
分辨率1k / 2k，默认 1k
文生图支持
参考图支持单张或多张，最多 10 张
单次生成数量固定 1，不支持一次生成多张
请求格式application/json
返回图片data[].url

计费方式

单价为 ¥0.12 / 张。当前每次请求固定生成 1 张图片，n 只能填写 1。

接口与鉴权 ​

项目地址
REST Base URLhttps://api.zmoapi.cn
SDK Base URLhttps://api.zmoapi.cn/v1
生成接口POST /v1/images/generations

请求头：

http
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

文生图 ​

bash
curl 'https://api.zmoapi.cn/v1/images/generations' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  --data-raw '{
    "model": "seedream-5.0",
    "prompt": "电影感产品摄影，主体居中，柔和自然光，背景简洁，高细节",
    "resolution": "2k",
    "size": "16:9",
    "n": 1
  }'

使用公网 URL 参考图 ​

参考图必须是无需登录即可直接访问的 HTTP(S) 图片直链，不能填写网页分享地址、需要 Cookie 的地址或 Markdown 图片语法。

单张参考图 ​

只有一张参考图时使用 image：

bash
curl 'https://api.zmoapi.cn/v1/images/generations' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  --data-raw '{
    "model": "seedream-5.0",
    "prompt": "保留参考图中的产品外形与主要结构，改为干净的商业摄影风格，背景使用柔和自然光",
    "resolution": "2k",
    "size": "1:1",
    "image": "https://example.com/reference.jpg",
    "n": 1
  }'

多张参考图 ​

使用 2–10 张参考图时改用 images 字符串数组。数组顺序会保留，建议在提示词中说明每张图的用途：

bash
curl 'https://api.zmoapi.cn/v1/images/generations' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  --data-raw '{
    "model": "seedream-5.0",
    "prompt": "第一张图作为商品主体参考，第二张图作为场景参考；保持商品结构不变，将商品自然放入目标场景",
    "resolution": "2k",
    "size": "4:5",
    "images": [
      "https://example.com/product.png",
      "https://example.com/scene.jpg"
    ],
    "n": 1
  }'

不要在同一个请求中同时传 image 和 images。

使用 Base64 参考图 ​

本地图片需要先转换为完整的 Data URI，再放入 JSON。必须包含 MIME 类型和 base64, 前缀：

json
{
  "model": "seedream-5.0",
  "prompt": "保留参考图主体，改为高级商品海报风格",
  "resolution": "1k",
  "size": "1:1",
  "image": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAA...",
  "n": 1
}

多张 Base64 参考图与公网 URL 可以混合使用：

json
{
  "model": "seedream-5.0",
  "prompt": "综合两张参考图生成统一风格的产品海报",
  "resolution": "2k",
  "size": "16:9",
  "images": [
    "https://example.com/product.jpg",
    "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAA..."
  ],
  "n": 1
}

Base64 格式

不要只传裸 Base64 字符串。正确格式是 data:image/png;base64,...、data:image/jpeg;base64,... 或与实际文件类型一致的完整 Data URI。

JavaScript 示例 ​

resolution、image 和 images 是 Seedream 的兼容扩展字段，推荐使用原生 HTTP 请求，避免部分 SDK 忽略扩展参数。

js
const response = await fetch("https://api.zmoapi.cn/v1/images/generations", {
  method: "POST",
  headers: {
    Authorization: "Bearer " + process.env.ZHM_API_KEY,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    model: "seedream-5.0",
    prompt: "保留商品外形，将背景改成明亮的现代展厅",
    resolution: "2k",
    size: "16:9",
    image: "https://example.com/product.png",
    n: 1,
  }),
});

const result = await response.json();

if (!response.ok) {
  throw new Error(JSON.stringify(result));
}

console.log(result.data[0].url);

Python 示例 ​

python
import requests

response = requests.post(
    "https://api.zmoapi.cn/v1/images/generations",
    headers={
        "Authorization": "Bearer YOUR_API_KEY",
        "Content-Type": "application/json",
    },
    json={
        "model": "seedream-5.0",
        "prompt": "保留商品外形，将背景改成明亮的现代展厅",
        "resolution": "2k",
        "size": "16:9",
        "image": "https://example.com/product.png",
        "n": 1,
    },
    timeout=300,
)

response.raise_for_status()
result = response.json()
print(result["data"][0]["url"])

请求参数 ​

参数类型必填说明
modelstring是固定填写 seedream-5.0
promptstring是图片生成或编辑要求，至少 1 个字符
resolutionstring否1k / 2k，默认 1k
sizestring否输出画面比例，默认 auto
imagestring否单张参考图，支持公网 URL 或完整 Data URI
imagesstring[]否多张参考图，1–10 项；支持公网 URL 或完整 Data URI
ninteger否固定为 1；不支持填写其他数值

size 可用值 ​

text
auto
1:1
3:2
2:3
4:3
3:4
5:4
4:5
16:9
9:16
2:1
1:2
3:1
1:3
21:9
9:21

不要同时传入相互冲突的画面比例参数。Seedream 5.0 当前公开参数中未列出 quality 和 response_format，接入时不要自行添加未确认字段。

成功响应 ​

json
{
  "created": 1784300000,
  "data": [
    {
      "url": "https://example.com/generated-image.png"
    }
  ]
}

单张结果读取：

js
const imageUrl = result.data[0].url;

返回的图片地址可能具有有效期。客户端收到结果后应及时下载或转存到自己的对象存储。

常见问题 ​

参考图传了但没有生效 ​

依次检查：

  1. URL 是否直接返回图片文件；
  2. URL 是否需要登录、Cookie、防盗链或临时页面跳转；
  3. Base64 是否包含完整的 data:image/...;base64, 前缀；
  4. 单图是否使用 image，多图是否使用 images；
  5. images 是否超过 10 项；
  6. 提示词是否明确说明需要保留和修改的内容。

为什么请求成功后只返回 1 张 ​

这是当前模型的固定行为。n 只能填写 1，不支持通过一次请求生成多张图片；如需多张，请分别发起多次请求。

为什么 2K 没有生效 ​

确认请求中传入的是小写：

json
{ "resolution": "2k" }

不要只修改 size；size 控制画面比例，resolution 控制 1K / 2K 档位。

接入注意 ​

  • 模型名必须完整填写为 seedream-5.0。
  • 文生图与参考图生成都调用 POST /v1/images/generations。
  • 参考图使用 JSON，不使用 multipart/form-data。
  • 单图使用 image，多图使用 images，最多 10 张。
  • n 固定为 1，每次请求只生成 1 张图片。
  • 1K 与 2K 当前均为 ¥0.12 / 张。
  • 创建请求网络超时不代表服务端一定没有收到任务，不要进行无条件立即重试。
  • API Key 只放在服务端环境变量或安全配置中。

相关页面 ​

知梦 API · 图像、视频与音乐生成接口文档

请妥善保管 API Key，仅在服务端安全调用