跳至正文
EN
获取 API Key
☰

Seedream 5.5 API 接入文档

使用 VezAPI 密钥接入 Seedream 5.5。下列操作共用同一个账号余额和鉴权方式。

服务地址： https://api.vezapi.com
请求头使用 Authorization: Bearer YOUR_VEZAPI_KEY。每次提交使用唯一的 Idempotency-Key，查询同一笔提交时才复用。

Seedream5.5 文生图

POST/api/v1/jobs/createTask

模型标识： seedream/5-5-text-to-image

参数类型说明与限制
model
必填		string

用于生成的模型名称。必填字段。 - 此端点必须使用 `seedream/5-5-text-to-image`

可选值："seedream/5-5-text-to-image"

默认："seedream/5-5-text-to-image"

callBackUrl
可选		string

接收生成任务完成更新的 URL。可选但建议在生产环境中使用。 - 当生成完成时，系统将向此 URL POST 任务状态和结果 - 回调包含生成的内容 URL 和任务信息 - 您的回调端点应接受包含结果的 JSON 负载的 POST 请求 - 或者，使用获取任务详情端点轮询任务状态 - 为确保回调安全性，请参阅 [Webhook 校验指南](/cn/common-api/webhook-verification) 了解签名验证实现方法

input
必填		object

生成任务的输入参数

input.prompt
必填		string

必填。文本提示词，5–5000 字符。

minLength: 5

maxLength: 5000

input.aspect_ratio
必填		string

必填。输出图像的宽高比。

可选值："1:1", "4:3", "3:4", "16:9", "9:16", "2:3", "3:2", "21:9"

input.size
可选		string

输出图像的清晰度档位，影响积分消耗。默认 `2K`。

可选值："1K", "1.5K", "2K"

默认："2K"

input.output_format
可选		string

输出图像格式。默认 `png`。

可选值："png", "jpeg"

默认："png"

input.background
可选		string

输出图像的背景。默认 `auto`。 - `auto`：由模型决定 - `transparent`：透明背景 - `opaque`：不透明背景 `transparent` 仅在 `output_format` 为 `png` 时可用。

可选值："auto", "transparent", "opaque"

默认："auto"

input.nsfw_checker
可选		boolean

默认 false。为 false 时不额外进行内容过滤，结果由模型直接返回。

请求示例
curl -X POST 'https://api.vezapi.com/api/v1/jobs/createTask' \
  -H 'Authorization: Bearer YOUR_VEZAPI_KEY' \
  -H 'Idempotency-Key: your-unique-request-id' \
  -H 'Content-Type: application/json' \
  -d '{
  "model": "seedream/5-5-text-to-image",
  "input": {
    "prompt": "高端护肤品电商主图，纯白柔光展台，玻璃精华瓶，商业写实摄影",
    "aspect_ratio": "1:1"
  }
}'
返回值与错误

HTTP 200

参数类型说明与限制
code
可选		integer

Status code of the request. The HTTP status is 200 even when the request fails, so always check this field: 200 means success; any other value means the request failed and msg describes the reason. Common values: 401 invalid or missing API key; 402 insufficient credits; 429 rate limit exceeded; 422 or 500 the request could not be processed (read msg and check your parameters before retrying).

可选值：200, 401, 402, 404, 422, 429, 455, 500, 501, 505

msg
可选		string

Response message, error description when failed

data
必填		object
data.taskId
可选		string

Task ID, can be used with Get Task Details endpoint to query task status

data.recordId
可选		string

Record ID, can be used to get the record details

HTTP 500

响应字段与业务状态码。

参数类型说明与限制
code
必填		integer

业务状态码：200 请求成功；401 鉴权凭据缺失或无效；402 积分不足；404 资源或接口不存在；408 超过 10 分钟未返回结果；422 参数校验失败；429 请求频率超限；455 系统维护；500 处理请求时发生内部错误；501 内容生成失败；505 功能当前关闭。

msg
必填		string

响应消息；失败时说明错误原因。

data
必填		object

Seedream5.5 图层分离

POST/api/v1/jobs/createTask

模型标识： seedream/5-5-layer-decomposition

参数类型说明与限制
model
必填		string

用于执行图层分离任务的模型名称。必填字段。 - 此端点必须使用 `seedream/5-5-layer-decomposition`

可选值："seedream/5-5-layer-decomposition"

默认："seedream/5-5-layer-decomposition"

callBackUrl
可选		string

接收任务完成通知的回调 URL。可选，但建议在生产环境中使用。 - 任务完成后，系统将向此 URL 发送 POST 请求 - 回调内容包含任务状态、生成结果 URL 和任务信息 - 也可以通过获取任务详情接口主动查询任务状态 - 回调签名校验方式请参考 [Webhook 校验指南](/cn/common-api/webhook-verification)

input
必填		object

图层分离任务的输入参数

input.image_url
必填		string

必填。待分离图片的 URL。 - 只能传 1 张，须为公网可访问地址 - 支持格式：JPEG、PNG、WEBP - 不超过 10 MB

input.prompt
可选		string

可选。描述要拆出的元素，0–2000 字符。 - 传入时，模型按描述分离指定元素 - 留空时，模型自动识别图片中的主要元素 - 可用 `<bbox>x1 y1 x2 y2</bbox>` 标注元素位置，坐标按 0–1000 归一化

minLength: 0

maxLength: 2000

input.size
可选		string

输出图片的清晰度档位。默认 `auto`。 - `auto`：保持原图尺寸（小于 1K 提升到 1K，大于 2K 压缩到 2K），按 2K 档计费 - `1K` / `1.5K` / `2K`：固定清晰度档位

可选值："auto", "1K", "1.5K", "2K"

默认："auto"

input.output_format
可选		string

底图的输出格式。默认 `png`。仅影响底图，分离出的图层固定为 PNG（透明背景）。

可选值："png", "jpeg"

默认："png"

input.max_images
可选		integer

最多输出的图片张数（含 1 张底图）。范围 2–100，默认 30。按实际拆出的张数计费。

默认：30

minimum: 2

maximum: 100

input.text_recognition
可选		boolean

是否识别图层中的文字。默认 `false`。

默认：false

input.nsfw_checker
可选		boolean

默认 false。为 false 时不额外进行内容过滤，结果由模型直接返回。

请求示例
curl -X POST 'https://api.vezapi.com/api/v1/jobs/createTask' \
  -H 'Authorization: Bearer YOUR_VEZAPI_KEY' \
  -H 'Idempotency-Key: your-unique-request-id' \
  -H 'Content-Type: application/json' \
  -d '{
  "model": "seedream/5-5-layer-decomposition",
  "input": {
    "image_url": "https://example.com/input.png",
    "prompt": "将标题文字 <bbox>179 58 809 197</bbox> 和鹦鹉 <bbox>330 274 641 991</bbox> 分离为独立图层"
  }
}'
返回值与错误

HTTP 200

参数类型说明与限制
code
可选		integer

Status code of the request. The HTTP status is 200 even when the request fails, so always check this field: 200 means success; any other value means the request failed and msg describes the reason. Common values: 401 invalid or missing API key; 402 insufficient credits; 429 rate limit exceeded; 422 or 500 the request could not be processed (read msg and check your parameters before retrying).

可选值：200, 401, 402, 404, 422, 429, 433, 455, 500, 501, 505

msg
可选		string

Response message, error description upon failure

data
必填		object
data.taskId
必填		string

The task ID can be used with the "Get Task Details" endpoint to query the task status.

HTTP 500

响应字段与业务状态码。

参数类型说明与限制
code
必填		integer

业务状态码：200 请求成功；401 鉴权凭据缺失或无效；402 积分不足；404 资源或接口不存在；408 超过 10 分钟未返回结果；422 参数校验失败；429 请求频率超限；455 系统维护；500 处理请求时发生内部错误；501 内容生成失败；505 功能当前关闭。

msg
必填		string

响应消息；失败时说明错误原因。

data
必填		object

Seedream5.5 图片编辑

POST/api/v1/jobs/createTask

模型标识： seedream/5-5-image-to-image

参数类型说明与限制
model
必填		string

用于生成的模型名称。必填字段。 - 此端点必须使用 `seedream/5-5-image-to-image`

可选值："seedream/5-5-image-to-image"

默认："seedream/5-5-image-to-image"

callBackUrl
可选		string

接收生成任务完成更新的 URL。可选但建议在生产环境中使用。 - 当生成完成时，系统将向此 URL POST 任务状态和结果 - 回调包含生成的内容 URL 和任务信息 - 您的回调端点应接受包含结果的 JSON 负载的 POST 请求 - 或者，使用获取任务详情端点轮询任务状态 - 为确保回调安全性，请参阅 [Webhook 校验指南](/cn/common-api/webhook-verification) 了解签名验证实现方法

input
必填		object

生成任务的输入参数

input.prompt
必填		string

必填。编辑指令，5–5000 字符。

minLength: 5

maxLength: 5000

input.image_urls
必填		array

必填。输入图片 URL（公网可访问的地址，非文件内容）。 - 1–10 张 - 支持格式：JPEG、PNG、WEBP - 单张不超过 10 MB - 每张输入图单独计费，价格见 [VezAPI.ai/pricing]([see VezAPI documentation])

minItems: 1

maxItems: 10

input.aspect_ratio
可选		string

必填。输出图像的宽高比。

可选值："1:1", "4:3", "3:4", "16:9", "9:16", "2:3", "3:2", "21:9", "auto"

默认："auto"

input.size
可选		string

输出图像的清晰度档位，影响积分消耗。默认 `2K`。

可选值："1K", "1.5K", "2K"

默认："2K"

input.output_format
可选		string

输出图像格式。默认 `png`。

可选值："png", "jpeg"

默认："png"

input.background
可选		string

输出图像的背景。默认 `auto`。 - `auto`：由模型决定 - `transparent`：透明背景 - `opaque`：不透明背景 `transparent` 仅在 `output_format` 为 `png` 时可用。

可选值："auto", "transparent", "opaque"

默认："auto"

input.nsfw_checker
可选		boolean

默认 false。为 false 时不额外进行内容过滤，结果由模型直接返回。

请求示例
curl -X POST 'https://api.vezapi.com/api/v1/jobs/createTask' \
  -H 'Authorization: Bearer YOUR_VEZAPI_KEY' \
  -H 'Idempotency-Key: your-unique-request-id' \
  -H 'Content-Type: application/json' \
  -d '{
  "model": "seedream/5-5-image-to-image",
  "input": {
    "prompt": "Keep the model'\''s pose and the flowing shape of the liquid dress unchanged. Change the clothing material from silver metal to completely transparent clear water (or glass). Through the liquid water, the model'\''s skin details are visible. Lighting changes from reflection to refraction.",
    "image_urls": [
      "https://example.com/input.png"
    ],
    "aspect_ratio": "auto"
  }
}'
返回值与错误

HTTP 200

参数类型说明与限制
code
可选		integer

Status code of the request. The HTTP status is 200 even when the request fails, so always check this field: 200 means success; any other value means the request failed and msg describes the reason. Common values: 401 invalid or missing API key; 402 insufficient credits; 429 rate limit exceeded; 422 or 500 the request could not be processed (read msg and check your parameters before retrying).

可选值：200, 401, 402, 404, 422, 429, 433, 455, 500, 501, 505

msg
可选		string

Response message, error description upon failure

data
必填		object
data.taskId
必填		string

The task ID can be used with the "Get Task Details" endpoint to query the task status.

HTTP 500

Server error.

参数类型说明与限制
code
必填		integer

Response status code - **200**: Success - Request has been processed successfully - **401**: Unauthorized - Authentication credentials are missing or invalid - **402**: Insufficient Credits - Account does not have enough credits to perform the operation - **404**: Not Found - The requested resource or endpoint does not exist - **408**: Timeout - No result has been returned for over 10 minutes. - **422**: Validation Error - The request parameters failed validation checks - **429**: Rate Limited - Request limit has been exceeded for this resource - **455**: Service Unavailable - System is currently undergoing maintenance - **500**: Server Error - An unexpected error occurred while processing the request - **501**: Generation Failed - Content generation task failed - **505**: Feature Disabled - The requested feature is currently disabled

msg
必填		string

Response message, error description when failed

data
必填		object

任务状态与回调

异步任务请保存返回的 taskId。调用 GET /api/v1/jobs/recordInfo?taskId=... 查询，或在创建时设置 callBackUrl。只有任务所属账号可以查询任务或基于任务创建派生资源。

超时可能表示请求已经受理。请在控制台查看原请求，不要自动新建任务。回调可能重试并重复到达，请使用 X-VezAPI-Event-Id 去重。

文件、日志与计费

生成媒体通常随上游保留 14 天，上传文件在 24 小时后失效。请在过期前保存所需文件。VezAPI 仅流式转发已登记资源，不提供永久作品库。请求日志保留两个自然月。

调用前预留积分，最终按实际优惠扣分 1:1 结算。用量不明时暂停新付费请求。若保护其他任务预留后余额不足以结算，会保留待结算记录，补足余额后再扣费；模型用量不会将钱包扣成负数。按时长计价的输入文件由服务端读取时长，读取失败时不提交模型任务。