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

# Seedream 图片生成 4.0

Seedream 4.0 是一款先进的图像生成模型，提供灵活的图像创建功能，包括支持 4K 分辨率，可以从文本和其他图像生成图像。

## 请求头

<ParamField header="Content-Type" type="string" required={true}>
  枚举值: `application/json`
</ParamField>

<ParamField header="Authorization" type="string" required={true}>
  Bearer 身份验证格式: Bearer \{\{API 秘钥}}。
</ParamField>

## 请求体

<ParamField body="prompt" type="string" required={true}>
  用于生成图像的提示词，支持中英文。

  建议不超过 300 个汉字或 600 个英文单词。字数过多信息容易分散，模型可能因此忽略细节，只关注重点，造成视图片缺失部分元素。
</ParamField>

<ParamField body="images" type="string[]" required={false}>
  输入要编辑的图像的 Base64 编码或可访问的 URL。支持输入单张或多张图像。

  * 图像 URL：确保图像 URL 可访问。
  * Base64 编码：格式必须为`data:image/<图像格式>;base64,<Base64 编码>`。<br />

    输入图像必须满足以下要求：

    * 图像格式：jpeg, png
    * 宽高比（宽度/高度）：范围为\[1/3, 3]
    * 宽度和高度（像素）：> 14
    * 大小：不超过 10 MB
    * 总像素值：不超过 `6000×6000` PX
    * 支持上传最多 10 张参考图像。
</ParamField>

<ParamField body="size" type="string" required={false}>
  设置生成图像的规格。有两种方法可用，但不能同时使用。

  * 方法 1，指定分辨率。
    * 可选值：`1K`, `2K`, `4K`
  * 方法 2，指定生成图像的宽度和高度（像素）。
    * 默认值：`2048x2048`
    * 总像素值范围：`[1024x1024, 4096x4096]`
    * 宽高比值范围：`[1/16, 16]`

  推荐的宽度和高度：

  | 宽高比  | 宽度和高度像素值  |
  | ---- | --------- |
  | 1:1  | 2048x2048 |
  | 4:3  | 2304x1728 |
  | 3:4  | 1728x2304 |
  | 16:9 | 2560x1440 |
  | 9:16 | 1440x2560 |
  | 3:2  | 2496x1664 |
  | 2:3  | 1664x2496 |
  | 21:9 | 3024x1296 |
</ParamField>

<ParamField body="sequential_image_generation" type="string" required={false} default="disabled">
  控制是否禁用批量生成功能。

  * `auto`：在自动模式下，模型会根据用户的提示词自动决定是否返回多张图像以及包含多少张图像。
  * `disabled`：禁用批量生成功能。模型将只生成一张图像。
</ParamField>

<ParamField body="max_images" type="integer" required={false} default={15}>
  指定此请求中要生成的最大图像数量。此参数仅在`sequential_image_generation`设置为`auto`时有效。

  取值范围：`[1, 15]`

  <Tip>
    说明

    实际生成的图像数量受`max_images`和输入参考图像数量的影响。输入参考图像数量 + 生成图像数量 ≤ 15。
  </Tip>
</ParamField>

<ParamField body="watermark" type="boolean" required={false} default={true}>
  为生成的图像添加水印。

  * `false`：不添加水印。
  * `true`：在图像的右下角添加带有 "AI 生成" 文字的水印。
</ParamField>

## 响应信息

<ResponseField name="images" type="string[]" required={false}>
  包含生成图像下载链接的数组。
</ResponseField>