curl --request POST \
--url https://api.evolink.ai/v1/images/generations \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"model": "doubao-seedream-5.5-layerize",
"image_urls": [
"https://example.com/poster.png"
],
"quality": "auto",
"output_format": "png",
"n": 30,
"model_params": {
"text_recognition": true
}
}
'{
"created": 1757165031,
"id": "task-unified-1793612934-seedream55layerize",
"model": "doubao-seedream-5.5-layerize",
"object": "image.generation.task",
"progress": 0,
"status": "pending",
"task_info": {
"can_cancel": true,
"estimated_time": 150
},
"type": "image",
"usage": {
"billing_rule": "per_image",
"credits_reserved": 55.624,
"user_group": "default"
}
}{
"error": {
"code": "invalid_request",
"message": "Invalid request parameters",
"type": "invalid_request_error"
}
}{
"error": {
"code": "unauthorized",
"message": "Invalid or expired token",
"type": "authentication_error"
}
}{
"error": {
"code": "insufficient_quota",
"message": "Insufficient quota. Please top up your account.",
"type": "insufficient_quota"
}
}{
"error": {
"code": "model_access_denied",
"message": "Token does not have access to model: doubao-seedream-5.5-layerize",
"type": "invalid_request_error"
}
}{
"error": {
"code": "rate_limit_exceeded",
"message": "Too many requests, please try again later",
"type": "rate_limit_error"
}
}{
"error": {
"code": "internal_error",
"message": "Internal server error",
"type": "api_error"
}
}Seedream 5.5
Seedream 5.5 图层拆分
🚧 该模型暂未开放，敬请期待
- Seedream 5.5 图层拆分 (doubao-seedream-5.5-layerize) 可将一张图片拆分为底图和多个独立图层
- 输入须为
1张图片；prompt可选，不传时自动识别并拆分画面中的主要元素 - 可通过
n设置最大输出数量，通过model_params.text_recognition启用文字识别 - 异步处理，使用返回的任务 ID 查询任务状态
- 生成的图像链接，有效期为24小时，请尽快保存
输出说明
- 底图格式由
output_format决定，独立图层均为带透明通道的 PNG - 任务详情的
result_data中，每张图片附带z_index（叠放顺序，底图为0，图层从1递增）与background（底图为opaque，图层为transparent），图层还带bounding_box（absolute为底图坐标系的像素坐标，normalized值域0~1000）、name与description - 任一图层生成失败，整个任务失败并全额退款，不返回部分成功结果
计费说明
- 底图与每个图层分别按张计费，输入图片另行收费
- 创建任务时，按
1张输入图片和最多n张输出图片预扣费用；完成后按实际输出数量结算，差额自动退回
POST
/
v1
/
images
/
generations
curl --request POST \
--url https://api.evolink.ai/v1/images/generations \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"model": "doubao-seedream-5.5-layerize",
"image_urls": [
"https://example.com/poster.png"
],
"quality": "auto",
"output_format": "png",
"n": 30,
"model_params": {
"text_recognition": true
}
}
'{
"created": 1757165031,
"id": "task-unified-1793612934-seedream55layerize",
"model": "doubao-seedream-5.5-layerize",
"object": "image.generation.task",
"progress": 0,
"status": "pending",
"task_info": {
"can_cancel": true,
"estimated_time": 150
},
"type": "image",
"usage": {
"billing_rule": "per_image",
"credits_reserved": 55.624,
"user_group": "default"
}
}{
"error": {
"code": "invalid_request",
"message": "Invalid request parameters",
"type": "invalid_request_error"
}
}{
"error": {
"code": "unauthorized",
"message": "Invalid or expired token",
"type": "authentication_error"
}
}{
"error": {
"code": "insufficient_quota",
"message": "Insufficient quota. Please top up your account.",
"type": "insufficient_quota"
}
}{
"error": {
"code": "model_access_denied",
"message": "Token does not have access to model: doubao-seedream-5.5-layerize",
"type": "invalid_request_error"
}
}{
"error": {
"code": "rate_limit_exceeded",
"message": "Too many requests, please try again later",
"type": "rate_limit_error"
}
}{
"error": {
"code": "internal_error",
"message": "Internal server error",
"type": "api_error"
}
}授权
##所有接口均需要使用Bearer Token进行认证##
获取 API Key ：
访问 API Key 管理页面 获取您的 API Key
使用时在请求头中添加：
Authorization: Bearer YOUR_API_KEY
请求体
application/json
图像生成模型名称
可用选项:
doubao-seedream-5.5-layerize 示例:
"doubao-seedream-5.5-layerize"
待拆分的图片 URL（必填）
注意：
- 必须恰好
1张，不传或传2张及以上都会报错 - 支持的图像格式：
.png、.jpeg、.jpg（比普通生成更严格，webp 等格式会被拒绝） - 图像大小：不超过
30MB - 总像素范围：
[262144, 6000×6000]，即最低512×512（下限高于普通生成） - 宽高比（宽/高）范围：
[1/16, 16] - 图像URL需要服务器能直接查看，或者图像URL在访问时会直接进行下载（一般这种URL是以图像的扩展名作为结尾，例如
.png、.jpg） - 输入图片另行收费
Required array length:
1 element示例:
["https://example.com/poster.png"]
指定要拆分的元素（选填）
三种用法：
- 不传：模型自动识别画面中所有主要元素并逐一拆分
- 自然语言：如
把鹦鹉和标题文字拆出来，按语义识别并分层 - 坐标精准：用
<bbox>标签指定位置，如标题文字<bbox>179 58 809 197</bbox>，推荐使用归一化坐标（0~1000）
示例:
"把鹦鹉和标题文字拆出来"
最大输出图片数量，包含底图，默认 30。
说明：
- 取值范围为
2~100，超出范围返回400，不计费 - 达到上限后停止拆分，其余元素可能被合并或省略；增大该值可提高拆分细度
n越大，预扣费用越高；任务完成后按实际输出数量结算，差额自动退回
必填范围:
2 <= x <= 100示例:
30
输出分辨率，默认 auto。
可选值： auto、1K、1.5K、2K
说明：
- 仅支持以上分辨率选项，传入比例（如
16:9）或像素尺寸（如2048x2048）将返回错误 auto表示输出跟随输入图：原始尺寸落在[921600, 4624220]像素区间内按原尺寸输出，小于 1K 按 1K 输出，大于 2K 按 2K 输出- 每个图层各自保持它在原图中的宽高比，底图的宽高比与输入图一致
可用选项:
auto, 1K, 1.5K, 2K 示例:
"auto"
提示词优化模式，仅支持 standard（默认）。
传入 fast 将返回 400，不计费。
可用选项:
standard 示例:
"standard"
输出图片格式
可选值：
png: PNG 格式（默认）jpeg: JPEG 格式
注意： 该参数仅控制底图，拆分出的图层固定为带透明通道的 png，不受此参数影响。
可用选项:
png, jpeg 示例:
"png"
图层拆分的附加选项。只接受 text_recognition，传其它键会返回 400。
Show child attributes
Show child attributes
任务完成后的HTTPS回调地址
回调时机：
- 任务完成（completed）、失败（failed）或取消（cancelled）时触发
- 在计费确认完成后发送
安全限制：
- 仅支持HTTPS协议
- 禁止回调到内网IP地址（127.0.0.1、10.x.x.x、172.16-31.x.x、192.168.x.x等）
- URL长度不超过
2048字符
回调机制：
- 超时时间：
10秒 - 失败后最多重试
3次（会分别在失败的1秒/2秒/4秒后进行重试） - 回调响应体格式与任务查询接口返回的格式一致
- 回调地址若返回2xx状态码视为成功，其他状态码会触发重试
示例:
"https://your-domain.com/webhooks/image-task-completed"
响应
图像生成任务创建成功
任务创建时间戳
示例:
1757165031
任务ID
示例:
"task-unified-1793612934-seedream55layerize"
实际使用的模型名称
示例:
"doubao-seedream-5.5-layerize"
任务的具体类型
可用选项:
image.generation.task 任务进度百分比 (0-100)
必填范围:
0 <= x <= 100示例:
0
任务状态
可用选项:
pending, processing, completed, failed 示例:
"pending"
异步任务信息
Show child attributes
Show child attributes
任务的输出类型
可用选项:
text, image, audio, video 示例:
"image"
使用量和计费信息
Show child attributes
Show child attributes