Seedream4.0 图片编辑

使用 bytedance/seedream-v4-edit 生成内容

curl --request POST \
  --url https://api.kie.ai/api/v1/jobs/createTask \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "bytedance/seedream-v4-edit",
  "callBackUrl": "https://your-domain.com/api/callback",
  "input": {
    "prompt": "参考此标志，为名为‘KIE AI’的户外运动品牌创作一张视觉展示图。在同一张图中呈现五件品牌周边产品：一个包装袋、一顶帽子、一个纸箱、一个腕带和一条挂绳。主视觉色调为蓝色，风格活泼简约且兼具现代感。",
    "image_urls": [
      "https://file.aiquickdraw.com/custom-page/akr/section-images/1757930552966e7f2on7s.png"
    ],
    "image_size": "square_hd",
    "image_resolution": "1K",
    "max_images": 1
  }
}
'

{
  "code": 200,
  "msg": "success",
  "data": {
    "taskId": "task_bytedance_1765176680149"
  }
}

POST

api

jobs

createTask

使用 bytedance/seedream-v4-edit 生成内容

curl --request POST \
  --url https://api.kie.ai/api/v1/jobs/createTask \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "bytedance/seedream-v4-edit",
  "callBackUrl": "https://your-domain.com/api/callback",
  "input": {
    "prompt": "参考此标志，为名为‘KIE AI’的户外运动品牌创作一张视觉展示图。在同一张图中呈现五件品牌周边产品：一个包装袋、一顶帽子、一个纸箱、一个腕带和一条挂绳。主视觉色调为蓝色，风格活泼简约且兼具现代感。",
    "image_urls": [
      "https://file.aiquickdraw.com/custom-page/akr/section-images/1757930552966e7f2on7s.png"
    ],
    "image_size": "square_hd",
    "image_resolution": "1K",
    "max_images": 1
  }
}
'

{
  "code": 200,
  "msg": "success",
  "data": {
    "taskId": "task_bytedance_1765176680149"
  }
}

查询任务状态

提交任务后，可通过统一的查询端点查看任务进度并获取处理结果：

获取任务详情

了解如何查询任务状态并获取编辑结果

生产环境中，建议使用 callBackUrl 参数接收编辑完成的自动通知，而非轮询状态端点。

市场概览

浏览所有可用模型

通用 API

查看账户积分与使用情况

Authorizations

Authorization

string

header

required

所有 API 都需要通过 Bearer Token 进行身份验证。

获取 API Key：

访问 API Key 管理页面获取您的 API Key

使用方法：在请求头中添加： Authorization: Bearer YOUR_API_KEY

注意事项：

请妥善保管您的 API Key，切勿泄露给他人
若怀疑 API Key 泄露，请立即在管理页面重置

Body

application/json

model

enum<string>

default:bytedance/seedream-v4-edit

required

用于生成任务的模型名称。必填字段。

该端点必须使用 bytedance/seedream-v4-edit 模型

可用选项:

bytedance/seedream-v4-edit

Example:

"bytedance/seedream-v4-edit"

callBackUrl

string<uri>

接收生成任务完成通知的回调 URL。可选配置，建议在生产环境中使用。

任务生成完成后，系统会向该 URL POST 任务状态与结果
回调内容包含生成的资源 URL 与任务相关信息
您的回调端点需要支持接收带 JSON 负载的 POST 请求
也可以选择调用任务详情端点，主动轮询任务状态

Example:

"https://your-domain.com/api/callback"

input

object

生成任务的输入参数

显示子属性

input.prompt

string

required

用于图像编辑的文本提示词（最大长度：5000 字符）

Maximum string length: 5000

Example:

"参考此标志，为名为‘KIE AI’的户外运动品牌创作一张视觉展示图。在同一张图中呈现五件品牌周边产品：一个包装袋、一顶帽子、一个纸箱、一个腕带和一条挂绳。主视觉色调为蓝色，风格活泼简约且兼具现代感。"

input.image_urls

string<uri>[]

required

用于编辑的输入图像 URL 列表。目前最多支持传入 10 张图像。（为上传后的文件 URL，而非文件内容；支持类型：image/jpeg、image/png、image/webp；最大大小：10.0MB）

Maximum array length: 10

Example:

[
  "https://file.aiquickdraw.com/custom-page/akr/section-images/1757930552966e7f2on7s.png"
]

input.image_size

enum<string>

default:square_hd

生成图像的尺寸规格

可用选项:

square,

square_hd,

portrait_4_3,

portrait_3_2,

portrait_16_9,

landscape_4_3,

landscape_3_2,

landscape_16_9,

landscape_21_9

Example:

"square_hd"

input.image_resolution

enum<string>

default:1K

最终图像分辨率由 image_size（宽高比）和 image_resolution（像素尺度）共同决定。例如，选择 4:3 比例 + 4K 分辨率，将得到 4096 × 3072 像素的图像

可用选项:

1K,

2K,

4K

Example:

"1K"

input.max_images

number

default:1

设置单次生成任务可产出的图像数量上限（取值范围 1–6）。由于这些图像是一次性生成而非分批次请求，你需要在提示词中明确说明所需图像数量，确保与该参数设置保持一致。（最小值：1，最大值：6，步长：1）

必填范围: 1 <= x <= 6

Example:

1

input.seed

integer

用于控制图像生成随机性的随机种子

Response

请求成功

code

enum<integer>

响应状态码

200: 成功 - 请求已处理完成
401: 未授权 - 身份验证凭据缺失或无效
402: 积分不足 - 账户积分不足以执行该操作
404: 未找到 - 请求的资源或端点不存在
422: 验证错误 - 请求参数未通过校验
429: 速率限制 - 已超出该资源的请求频次限制
455: 服务不可用 - 系统正在维护中
500: 服务器错误 - 处理请求时发生意外故障
501: 生成失败 - 内容生成任务执行失败
505: 功能禁用 - 当前请求的功能暂未开放

可用选项:

200,

401,

402,

404,

422,

429,

455,

500,

501,

505

msg

string

响应消息，请求失败时为错误描述

Example:

"success"

data

object

显示子属性

data.taskId

string

任务 ID，可用于调用任务详情端点查询任务状态

Example:

"task_bytedance_1765176680149"

Seedream4.0 文生图 Seedream4.5 文生图

⌘I

图像系列

视频系列

音频系列

Seedream4.0 图片编辑

查询任务状态

获取任务详情

相关资源

市场概览

通用 API

Authorizations

Body

Response

图像系列

视频系列

音频系列

​查询任务状态

获取任务详情

​相关资源

市场概览

通用 API

Authorizations

Body

Response

查询任务状态

相关资源