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

# seedream-5.0

> Seedream 5.0 文生图与图生图同步 API。

`doubao-seedream-5-0-260128` 的文生图和图生图能力共用 `POST /v1/images/generations`。

<Tabs sync={false}>
  <Tab title="文生图">
    ## 生成图片

    `POST /v1/images/generations`

    <div className="kling-api-example-panel">
      ```bash cURL theme={null}
      curl --request POST \
        --url https://www.anyfast.com.cn/v1/images/generations \
        --header 'Authorization: Bearer YOUR_API_KEY' \
        --header 'Content-Type: application/json' \
        --data '{
          "model": "doubao-seedream-5-0-260128",
          "prompt": "日出时分宁静的山景，山谷间弥漫着薄雾",
          "size": "2048x2048",
          "seed": 42,
          "watermark": false,
          "logo_info": {"add_logo": false}
        }'
      ```
    </div>

    ## 请求头

    <ParamField header="Authorization" type="string" required>Bearer 鉴权，格式为 `Bearer YOUR_API_KEY`。</ParamField>
    <ParamField header="Content-Type" type="string" default="application/json" required>请求体格式。</ParamField>

    ## 请求体

    <ParamField body="model" type="string" required>固定为 `doubao-seedream-5-0-260128`。</ParamField>
    <ParamField body="prompt" type="string" required>图片生成提示词。</ParamField>
    <ParamField body="size" type="string">输出图片尺寸，见下方支持尺寸。</ParamField>
    <ParamField body="watermark" type="boolean" default={false}>是否添加水印。</ParamField>
    <ParamField body="seed" type="integer">随机种子，用于复现结果。</ParamField>
    <ParamField body="logo_info" type="object">自定义 Logo 水印配置。</ParamField>
    <ParamField body="logo_info.add_logo" type="boolean">是否添加 Logo。</ParamField>
    <ParamField body="logo_info.position" type="integer">Logo 位置。</ParamField>
    <ParamField body="logo_info.language" type="integer">Logo 语言。</ParamField>
    <ParamField body="logo_info.opacity" type="number">Logo 透明度，范围为 0–1。</ParamField>

    ## 生成响应

    <div className="kling-api-example-panel">
      ```json 200 theme={null}
      {
        "model": "doubao-seedream-5-0-260128",
        "created": 1775029815,
        "data": [
          {
            "url": "https://example.com/generated-image.png",
            "size": "2048x2048"
          }
        ],
        "usage": {
          "generated_images": 1,
          "output_tokens": 16384,
          "total_tokens": 16384
        }
      }
      ```
    </div>

    <ResponseField name="model" type="string">本次请求使用的模型 ID。</ResponseField>
    <ResponseField name="created" type="integer">请求创建时间，Unix 秒级时间戳。</ResponseField>
    <ResponseField name="data" type="object[]">生成图片列表。</ResponseField>
    <ResponseField name="data[].url" type="string">生成图片 URL。</ResponseField>
    <ResponseField name="data[].size" type="string">生成图片尺寸。</ResponseField>
    <ResponseField name="usage" type="object">用量信息。</ResponseField>
    <ResponseField name="usage.generated_images" type="integer">成功生成的图片数量。</ResponseField>
    <ResponseField name="usage.output_tokens" type="integer">输出 Token 数量。</ResponseField>
    <ResponseField name="usage.total_tokens" type="integer">总 Token 数量。</ResponseField>
  </Tab>

  <Tab title="图生图">
    ## 生成图片

    `POST /v1/images/generations`

    <div className="kling-api-example-panel">
      ```bash cURL theme={null}
      curl --request POST \
        --url https://www.anyfast.com.cn/v1/images/generations \
        --header 'Authorization: Bearer YOUR_API_KEY' \
        --header 'Content-Type: application/json' \
        --data '{
          "model": "doubao-seedream-5-0-260128",
          "prompt": "结合两张参考图生成三张连贯的游乐园电影分镜",
          "image": [
            "https://example.com/reference-1.png",
            "https://example.com/reference-2.png"
          ],
          "sequential_image_generation": "auto",
          "sequential_image_generation_options": {"max_images": 3},
          "size": "2048x2048",
          "watermark": false
        }'
      ```
    </div>

    ## 请求头

    <ParamField header="Authorization" type="string" required>Bearer 鉴权，格式为 `Bearer YOUR_API_KEY`。</ParamField>
    <ParamField header="Content-Type" type="string" default="application/json" required>请求体格式。</ParamField>

    ## 请求体

    <ParamField body="model" type="string" required>固定为 `doubao-seedream-5-0-260128`。</ParamField>
    <ParamField body="prompt" type="string" required>图片编辑或参考生成提示词。</ParamField>
    <ParamField body="image" type="string[]" required>参考图片 URL 或 Base64 data URI 数组。</ParamField>
    <ParamField body="sequential_image_generation" type="string">设为 `auto` 开启连续图片生成。</ParamField>
    <ParamField body="sequential_image_generation_options" type="object">连续图片生成选项。</ParamField>
    <ParamField body="sequential_image_generation_options.max_images" type="integer">连续生成的最大图片数量。</ParamField>
    <ParamField body="size" type="string">输出图片尺寸，见下方支持尺寸。</ParamField>
    <ParamField body="watermark" type="boolean" default={false}>是否添加水印。</ParamField>
    <ParamField body="seed" type="integer">随机种子，用于复现结果。</ParamField>
    <ParamField body="logo_info" type="object">自定义 Logo 水印配置。</ParamField>

    <Warning>使用外部图片 URL 时，请确保上游可在 10 秒内完成下载；较大文件建议使用 Base64 data URI。</Warning>

    ## 生成响应

    <div className="kling-api-example-panel">
      ```json 200 theme={null}
      {
        "model": "doubao-seedream-5-0-260128",
        "created": 1775029815,
        "data": [
          {"url": "https://example.com/generated-image-1.png", "size": "2048x2048"},
          {"url": "https://example.com/generated-image-2.png", "size": "2048x2048"},
          {"url": "https://example.com/generated-image-3.png", "size": "2048x2048"}
        ],
        "usage": {
          "generated_images": 3,
          "output_tokens": 49152,
          "total_tokens": 49152
        }
      }
      ```
    </div>

    <ResponseField name="model" type="string">本次请求使用的模型 ID。</ResponseField>
    <ResponseField name="created" type="integer">请求创建时间，Unix 秒级时间戳。</ResponseField>
    <ResponseField name="data" type="object[]">生成图片列表。</ResponseField>
    <ResponseField name="data[].url" type="string">生成图片 URL。</ResponseField>
    <ResponseField name="data[].size" type="string">生成图片尺寸。</ResponseField>
    <ResponseField name="usage" type="object">用量信息。</ResponseField>
    <ResponseField name="usage.generated_images" type="integer">成功生成的图片数量。</ResponseField>
    <ResponseField name="usage.output_tokens" type="integer">输出 Token 数量。</ResponseField>
    <ResponseField name="usage.total_tokens" type="integer">总 Token 数量。</ResponseField>
  </Tab>
</Tabs>

## 支持的尺寸

`2048x2048`、`1728x2304`、`2304x1728`、`2848x1600`、`1600x2848`、`2496x1664`、`1664x2496`、`3136x1344`、`3072x3072`、`2592x3456`、`3456x2592`、`4096x2304`、`2304x4096`、`2496x3744`、`3744x2496`、`4704x2016`。

<script src="/feedback.js" />
