seedream 4.5:在 Agent 里调用豆包 Seedream 4.5 做文生视频与图生视频

前言

要在对话里直接出短视频,常见做法是单独打开控制台、手写 HTTP 请求,或在本地脚本里维护上传、轮询和结果 URL。参数变一点就要改代码,Agent 也很难按统一流程帮你跑通。

下面介绍 SkillHub 上的社区 Skill seedream 4.5(坐标 @user_f95f21b8/dlazy-seedream-4-5,当前版本 1.0.9)。它把 Doubao Seedream 4.5 的生成能力封装成标准 SKILL.md,由 Agent 通过 dLazy CLI 调用云端 API,支持文生视频与图生视频。页面标注 requires_api_key=true,使用前需要自备 dLazy API Key。

这是什么

seedream 4.5 是面向 design-media 类任务的 Agent Skill:用豆包 Seedream 4.5 生成流畅、高质量视频。维护方在 Skill 元数据中写明 CLI 由 dlazyai 维护,推理与媒体存储走 dLazy 托管服务(api.dlazy.com、files.dlazy.com)。

Skill 在 SkillHub 归类为 design-media,来源为 community,发布者为 user_f95f21b8。截至资料抓取时,SkillHub 显示评分 100000、下载 1348、安装 7(以 SkillHub 页面 为准)。

官方入口:

  • API / 安装指引:https://api.skillhub.cn/user_f95f21b8/dlazy-seedream-4-5
  • 展示页:https://www.skillhub.cn/skills/user_f95f21b8/dlazy-seedream-4-5

核心功能

依据 Skill 包内 SKILL.md(v1.0.9),已核实能力如下:

  1. 文生视频、图生视频:通过 dlazy seedream-4.5 提交提示词;图生场景可传入本地路径或 URL 的参考图(帮助文档中参数名为 --images,示例里亦出现 --image,以 dlazy seedream-4.5 -h 为准)。
  2. 画面参数:--resolution 可选 2k、4k(默认 2k);--size 支持 1:1、4:3、3:4、16:9、9:16、3:2、2:3、21:9(默认 16:9)。
  3. 成本控制与异步:--dry-run 只打印请求体与费用估算;--no-wait 立即返回 generateId,可用 dlazy status <generateId> --wait 轮询;--timeout 默认最长等待 1800 秒。
  4. 触发词:中英文 Skill 均列出如「豆包 seedream 4.5」「生成视频」「文生视频、图生视频」等,便于 Agent 识别意图。

底层模型 ID 在返回 JSON 中为 doubao-seedream-4_5。

安装与启用

安装分两层:先把 Skill 装进当前 Agent 的 skills 目录,再安装并配置 dLazy CLI。

1. 安装 SkillHub CLI(若尚未安装)

command -v skillhub && skillhub --version

未安装时可按 SkillHub 安装文档 执行完整安装或仅 CLI 安装,例如:

curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash

2. 将 Skill 安装到当前 Agent 目录

SkillHub 要求用 --dir 指向当前 Agent 实际读取的 skills 目录,否则默认落在 ./skills/ 可能不会被识别。

skillhub install @user_f95f21b8/dlazy-seedream-4-5 --dir <你的 skills 目录>

常见路径(来自 SkillHub 安装文档):

  • Cursor:~/.cursor/skills/
  • Claude Code:~/.claude/skills/
  • Codex:~/.codex/skills/ 或项目下的 .agents/skills/

也可把下面提示词发给 Agent,让其按 https://skillhub.cn/install/skillhub.md 完成安装:

请根据 https://skillhub.cn/install/skillhub.md,安装 `@user_f95f21b8/dlazy-seedream-4-5`。

3. 安装 dLazy CLI

Skill 元数据固定 CLI 版本 @dlazy/cli@1.0.9,依赖本机 npm / npx。

全局安装:

npm install -g @dlazy/cli@1.0.9

或按需调用、不装全局:

npx @dlazy/cli@1.0.9 <command>

源码与包信息:https://github.com/dlazyai/cli、https://www.npmjs.com/package/@dlazy/cli。

4. 配置 API Key

所有请求需要 dLazy API Key。推荐写入用户配置(Linux/macOS 为 ~/.dlazy/config.json):

dlazy auth set YOUR_API_KEY

也可通过环境变量 DLAZY_API_KEY 按次传入。Key 在 dlazy.com/dashboard/organization/api-key 获取,需在 dlazy.com 注册或登录。

典型用法

Agent 侧的核心指令是执行 dlazy seedream-4.5。先查看帮助:

dlazy seedream-4.5 -h

文生视频(仅提示词)——按 Skill 要求提供 --prompt:

dlazy seedream-4.5 --prompt '一只猫在窗边打盹,镜头缓慢推进'

图生视频(本地参考图)——Skill 文档示例:

dlazy seedream-4.5 --prompt '提示词内容' --image '/path/to/image.png'

图生视频(远程 URL):

dlazy seedream-4.5 --prompt '提示词内容' --image 'https://files.dlazy.com/image.png'

调用前可用 --dry-run 查看 payload 与费用估算;长任务可加 --no-wait,再轮询状态。

成功时 CLI 返回结构化 JSON,其中 result.tool 为 seedream-4.5,result.outputs 含生成资源的 url(托管在 files.dlazy.com)。本地路径会先由 CLI 上传到 dLazy 媒体存储再参与推理。

适用场景与注意

适合谁

  • 已在 Cursor、Claude Code、Codex 等环境使用 Skills,希望在对话里完成短视频草稿或图生视频迭代。
  • 接受 SaaS 计费与云端推理,愿意用 dLazy 账号与积分管理用量。

限制与注意

  1. 必须联网且有 API Key:未配置或 Key 无效会返回 unauthorized;余额不足为 insufficient_balance,需在 积分设置 充值。
  2. 数据出本地:提示词与上传的本地文件会发往 dLazy API / 存储,需符合团队合规要求;服务条款见 dlazy.com。
  3. 参考图数量:帮助文档写明 --images 最多 10 张;安装前建议在 GitHub 审阅 CLI 源码(Skill 元数据中的建议)。
  4. 版本对齐:Skill 1.0.9 与 CLI 1.0.9 绑定,混用其他 CLI 版本可能行为不一致。

结尾

seedream 4.5 把 Doubao Seedream 4.5 的视频生成收敛成一条 Agent 可执行的 CLI 流程:SkillHub 安装 Skill、配置 dLazy 密钥、用 dlazy seedream-4.5 完成文生视频或图生视频。需要查阅坐标与版本时,以官方地址为准:https://api.skillhub.cn/user_f95f21b8/dlazy-seedream-4-5。

羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

小夜