如何使用 Seedream 5.0 Lite API 2026：EvoLink 异步工作流的逐步集成指南

概要

• Seedream 5.0 Lite 强调深度思考 + 实时搜索增强（搜索功能可根据产品实现开启/关闭）。
• 如果通过 EvoLink 集成，核心模式为：
  • POST https://api.evolink.ai/v1/images/generations
  • 然后轮询 GET https://api.evolink.ai/v1/tasks/{task_id}
  • 及时保存结果（生成的链接可能有时效限制）。
• Seedream 5.0 正在 EvoLink 上逐步上线（分阶段发布；请查看控制台模型列表）。

1. Seedream 5.0 Lite 是什么（以及不应过度宣传的内容）

可以安全声明的

Seedream 5.0 Lite 定位为更智能的图像模型，具备：

• 更强的跨模态理解和推理能力，
• 改进的主体一致性和图文对齐，
• 实时搜索增强，处理时效性生成（特别适用于包含实时信息的海报）。

没有官方 API 证明不应声明的

避免断言特定的未文档化 API 字段或机制，例如：

• conversation_id、enable_conversation、"多轮对话编辑会话"
• 固定的延迟开销数字（如"增加 2-5 秒"）
• 对现实世界事实的正确性保证

建议：描述"迭代编辑工作流"并参考文档获取确切的请求模式。

2. 接入方式（选择你的集成路径）

方案 A — BytePlus ModelArk（官方直连）

适合直接官方接入。使用 ModelArk 基础 URL + API Key 认证，直接调用图像生成 API。

方案 B — EvoLink（统一网关；推荐用于多模型工作流）

适合需要跨多个图像模型使用统一 API 接口的场景。

3. EvoLink 集成（Seedream 5.0 Lite 异步工作流）

本节遵循 EvoLink 的 Seedream 图像生成模式：提交 → 轮询 → 保存。

3.1 认证

所有 EvoLink API 使用 Bearer Token 认证：

Authorization: Bearer YOUR_API_KEY

在 EvoLink 控制台（API Key 管理）获取你的 API Key。

3.2 分步操作：提交 → 轮询 → 保存

第 1 步 — 提交图像生成任务

• size：比例（如 16:9）或像素（如 2048x2048）
• quality：2K 或 4K（配合比例格式使用）

curl --request POST \
  --url https://api.evolink.ai/v1/images/generations \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "doubao-seedream-5.0-lite",
    "prompt": "A clean product poster of a solar street light, studio lighting, white background, crisp typography, realistic materials.",
    "size": "16:9",
    "quality": "2K"
  }'

你将收到一个异步任务对象（示例）：

{
  "created": 1757165031,
  "id": "task-unified-1757165031-seedream5d",
  "model": "doubao-seedream-5.0-lite",
  "object": "image.generation.task",
  "progress": 0,
  "status": "pending",
  "task_info": {
    "can_cancel": true,
    "estimated_time": 45
  },
  "type": "image",
  "usage": {
    "billing_rule": "per_call",
    "credits_reserved": 3.0,
    "user_group": "default"
  }
}

Seedream 5.0 Lite 说明：正确的模型名称为 doubao-seedream-5.0-lite，如 EvoLink 官方文档所示。

第 2 步 — 轮询任务状态

curl --request GET \
  --url "https://api.evolink.ai/v1/tasks/task-unified-1757165031-seedream5d" \
  --header 'Authorization: Bearer YOUR_API_KEY'

{
  "created": 1756817821,
  "id": "task-unified-1756817821-4x3rx6ny",
  "model": "gpt-4o-image",
  "object": "image.generation.task",
  "progress": 100,
  "results": ["http://example.com/image.jpg"],
  "status": "completed",
  "task_info": { "can_cancel": false },
  "type": "image"
}

第 3 步 — 及时保存结果

3.3 EvoLink 请求参数（实用参考）

以下是与 EvoLink Seedream 5.0 文档对齐的参数汇总指南。

必填

• model（string）— 示例："doubao-seedream-5.0-lite"
• prompt（string）— 描述你想生成的图像，或如何编辑输入图像。限制：2000 tokens。

常用可选

• n（integer，1–15）— 最大生成图像数量。
  • 要生成多张图像，也可以在 prompt 中写"生成 2 张不同的图像"。
  • 参考图数量 + 最终生成图数量 ≤ 15。
  • 预扣费可能基于 n，而最终计费可能按实际生成数量。
• size（string）— 两种模式：
  • 比例格式：auto、1:1、2:3、3:2、3:4、4:3、4:5、5:4、9:16、16:9、21:9 — 配合 quality 自动选择分辨率。
  • 像素格式：宽x高（如 2048x2048、2560x1440、4096x4096）— 默认：2048x2048。像素范围：2560x1440 到 4096x4096。宽高比范围：1/16 到 16。
• quality（string enum）— 2K 或 4K。配合比例格式使用。
• prompt_priority（enum）— standard（更高质量输出，更长处理时间）。
• image_urls（图像 URL 数组）— 用于图生图/图像编辑工作流。限制：
  • 每次请求最多 14 张输入图像
  • 每张图像 ≤ 10MB
  • 格式：.jpeg、.jpg、.png、.webp、.bmp、.tiff、.gif
  • 宽高比（w/h）范围：1/16 到 16
  • 总像素 ≤ 6000×6000
• callback_url（string，仅 HTTPS）— 任务完成/失败/取消时调用的 Webhook（计费确认后）。
  • 仅支持 HTTPS
  • 禁止内网 IP 回调
  • 超时 10 秒；最多重试 3 次（1s / 2s / 4s）
  • 回调体与任务查询 API 响应格式一致

4. 提示词最佳实践（Seedream 风格）

Seedream 在你提供"设计师级约束"时表现最佳：

4.1 布局与构图

• "海报布局，标题在顶部，安全边距，居中主体产品，底部三分之一留白用于文案"
• "正面视角，平衡对称，简约背景"

4.2 排版（保持文字简短）

• 指定层级："1 个大标题 + 1 个短副标题 + 2 行要点"
• 指定清晰度："清晰可读的无衬线字体，高对比度，无风格化扭曲文字"

4.3 参考图像（品牌一致性）

• 品牌风格指南参考
• 产品照片参考
• 角色参考（如需保持角色一致性）

注意：参考图像 + 生成图像 ≤ 15。

5. 生产可靠性清单（EvoLink 异步）

• 429：指数退避 + 抖动
• 5xx：最多重试 3 次（2s → 4s → 8s）

• 前 20 秒以 2-3 秒间隔开始
• 之后 5-10 秒间隔
• 超过合理超时后停止并优雅标记为失败

• task_id
• 最终 results[] URL
• 你的 prompt + 参数（用于调试可复现性）

6. 成本控制策略（实用，模型无关）

• 默认使用 2K；4K 留给最终资产。
• 保持 n 较小，通过迭代 prompt 而非暴力尝试。
• 通过（model + prompt + size + quality + image_urls）的哈希缓存避免重复。
• 高流量任务使用 callback_url 避免频繁轮询。

总结

Seedream 5.0 Lite 最好定位为具有推理能力的图像模型，可选实时搜索增强用于时效性生成。对于开发者，最简洁的生产模式是：

1. 选择接入路径（ModelArk 直连 vs EvoLink 统一网关），
2. 实现稳定的异步工作流（提交 → 轮询/回调 → 保存），
3. 将高级功能视为"能力级别"，除非官方 API 模式有明确文档。

准备好在 EvoLink 上使用 Seedream 5.0 Lite 了吗？

• 🚀 即时接入 — 一个 Key，一个端点
• 🔧 统一 API — 跨模型一致的接口规范
• 📊 任务 + 用量可视化 — 可预测的异步工作流
• 🛡️ 生产就绪 — 回调支持和安全约束

1. 在 evolink.ai 注册并获取 API Key
2. 在控制台打开模型列表，找到 Seedream 5.0 Lite
3. 调用：

curl --request POST \
  --url https://api.evolink.ai/v1/images/generations \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "<SEEDREAM_5_0_LITE_MODEL_NAME_FROM_EVO_LINK_DASHBOARD>",
    "prompt": "A clean product poster of a solar street light, studio lighting, white background, crisp typography, realistic materials.",
    "size": "16:9",
    "quality": "2K"
  }'

然后查询：

curl --request GET \
  --url https://api.evolink.ai/v1/tasks/<task_id> \
  --header 'Authorization: Bearer YOUR_API_KEY'