1. 第三方接入
脑生云
  • 操作指南
    • 控制台指南
    • CC Switch 配置
      • 通用步骤
      • Claude Code 配置(CC Switch)
      • Claude Desktop 配置
      • Codex 配置(CC Switch)
    • CLI 配置
      • 环境检查(通用步骤)
      • Gemini CLI
      • Claude Code 配置(命令行)
      • Codex 配置(命令行)
      • Kimi Code 配置
    • 官方客户端
      • 官方客户端平台配置总览
      • Cursor
      • 扣子 / Coze
      • Trae
      • WorkBuddy(配置)
      • 千问办公
      • Claude Desktop
      • ChatGPT
    • 第三方接入
      • 第三方平台配置总览
      • n8n
      • Cherry Studio
      • Dify
      • Cline
      • LobeChat
      • ChatBox
      • GPT Academic
      • 沉浸式翻译
      • ChatGPT Sidebar
      • OpenClaw
      • VS Code
      • AionUi
      • OpenCode
      • Hermes
      • DeepSeek 接入 Claude Code
      • DeepSeek 接入 Codex
      • GPT 接入 Claude Code
      • 百度搭子
      • VOZEB 画布教程
      • VOZEB 本地启动教程
      • VOZEB 图生视频公网配置
    • 常见问题
      • WorkBuddy(常见问题)
      • Claude Code
      • Codex
  • 视频模型
    • 豆包 视频生成
      • 素材管理
        • 私域真人人像素材资产组合
          • 创建真人认证会话
          • 获取真人认证结果
        • 私域虚拟人像素材资产组合
          • 创建素材组
          • 查询素材组列表
          • 查询素材组详情
          • 更新素材组
          • 删除素材组
        • 私域 虚拟/真人 素材资产
          • 创建素材
          • 查询素材列表
          • 查询素材详情
          • 更新素材
          • 删除素材
      • 创建视频任务
      • 查询视频任务
      • 取消视频任务
    • 豆包 视频生成(新)
      • 素材管理
        • 私域真人人像素材资产组合
          • 创建真人认证会话
          • 获取真人认证结果
        • 私域虚拟人像素材资产组合
          • 创建素材组
          • 查询素材组列表
          • 查询素材组详情
          • 更新素材组
          • 删除素材组
        • 私域 虚拟/真人 素材资产
          • 创建素材
          • 查询素材列表
          • 查询素材详情
          • 更新素材
          • 删除素材
      • 创建视频任务
      • 查询视频任务
      • 火山原生创建视频任务
      • 火山原生查询视频任务
    • 万相 视频生成
      • 创建视频任务
      • 查询视频任务
      • 原生创建视频任务
      • 原生查询视频任务
  • 图片模型
    • GPT 图像生成
      • 同步生成图像
      • 提交异步生图任务
      • 查询异步生图任务
    • Gemini 同步生图
      • 同步生成图片
    • GPT 图像生成(新)
      • 同步生成图像
      • 同步编辑图像
      • 提交异步生图任务
      • 提交异步编辑任务
      • 查询异步生图任务
    • Gemini 图像生成(新)
      • 同步生成图像
  1. 第三方接入

VOZEB 画布教程

VOZEB PRO 视频与画布创作指南#

本指南面向使用 VOZEB PRO 的企业管理员与创作用户,介绍如何在 VOZEB PRO 中接入脑生云模型渠道,并调用文本、图片和视频模型完成视频创作与画布创作。
平台入口:VOZEB PRO GitHub | VOZEB PRO 演示站

脑生云连接参数#

配置项填写内容
渠道协议OpenAI(或 New API)
Base URLhttps://api.naoshengyun.com/v1
API Key在脑生云控制台创建的 API Key
Model ID控制台中当前 API Key 有权限使用的实际模型 ID

可用模型参考#

能力脑生云接口Model ID 示例
文本模型POST /v1/chat/completions以控制台“模型广场”中已开通的文本模型为准
图片模型POST /v1/images/generationsgpt-image-2
视频模型(万相)POST /v1/videoswan2.7-t2v、wan2.7-i2v、wan3.0-video
视频模型(豆包 Seedance)POST /v1/videosdoubao-seedance-2-0-260128、doubao-seedance-2-0-fast-260128、doubao-seedance-2-5-260628
提示:以上为示例,实际可用模型以脑生云控制台“模型广场”中当前 API Key 已开通的模型为准。

一、使用前准备#

企业管理员#

1.
完成 VOZEB PRO 部署,并通过 /install 安装向导初始化数据库、创建首个管理员账号。
2.
登录脑生云控制台,进入“API Key”页面创建一个 Key,用于 VOZEB PRO 渠道接入。
脑生云控制台创建 API Key
脑生云控制台“创建 API Key”对话框。
3.
在“模型广场”确认需要使用的文本、图片和视频模型均已开通。

创作用户#

1.
打开企业部署的 VOZEB PRO 站点,注册或使用管理员分配的账号登录。
2.
在“个人中心”确认账户积分充足;积分不足时生成任务无法提交。

二、渠道配置(管理员)#

VOZEB PRO 通过后台“模型渠道”接入上游模型,接入向导共五步:选择协议、连接上游、添加模型、同步模型、确认启用。

配置步骤#

截图采集时选择的是 自定义协议,与正文推荐的 OpenAI / New API 存在差异。配置时应以当前部署版本实际提供的协议选项为准,并确保 Base URL、API Key 与模型 ID 均可正常使用。
1.
使用管理员账号登录 VOZEB PRO,通过右上角头像菜单进入“管理员后台 → 上游配置 → 模型渠道”。
进入管理员后台
从右上角头像菜单进入“管理员后台”。
2.
点击“接入新渠道”;在接入向导第 1 步选择协议,点击“开始配置”。
接入新渠道
“模型渠道”页面中的“接入新渠道”入口。
选择上游协议
选择上游协议。该截图选择的是“自定义协议”,正文推荐 OpenAI 或 New API。
3.
渠道名称填写便于识别的名称,例如“脑生云”。
4.
Base URL 填写 https://api.naoshengyun.com/v1,API Key 填写脑生云 API Key,点击“下一步”。
连接上游
连接上游:填写渠道名称、Base URL 与 API Key。
5.
在“添加模型”步骤点击“同步模型”拉取模型目录;如果目录中没有需要的模型,输入 Model ID 后按 Enter 手动添加,可添加多个。
添加模型
添加模型:输入模型 ID,并核对文本、图片、视频能力类型。
6.
进入“同步模型”步骤,点击“同步并自动合并”,系统会按上游模型名自动建立逻辑模型;勾选“为尚未配置的能力设置默认模型”。
同步模型
同步模型:确认逻辑模型清单与默认模型设置。
7.
在“确认启用”步骤核对 Base URL 和模型列表,点击“启用渠道”。
确认启用
确认启用:核对渠道、Base URL、上游模型与逻辑绑定。
8.
返回“模型渠道”列表,确认新渠道已显示且处于启用状态,点击“保存更改”。
保存渠道更改
返回模型渠道列表后保存更改。
9.
进入“财务管理 → 积分规则”,为新接入的文本、图片、视频模型设置扣费规则。
配置积分规则
在“财务管理 → 积分规则”中配置图片、视频等模型的积分规则。

视频模型路由#

完成积分规则后,视频模型还需要检查逻辑模型的默认路由与能力档案。
1.
在模型管理页面点击视频逻辑模型的“路由设置”,确认默认模型和实际路由指向正确的上游渠道。
视频模型路由设置
检查默认模型,并进入对应视频模型的路由设置。
2.
在“能力档案”中勾选“参考图片”,按模型实际能力填写参考图数量、时长、比例和清晰度等限制,然后点击“应用修改”。
勾选参考图片能力
为视频模型勾选“参考图片”,并填写能力档案。

豆包 Seedance 多模态参考(可选)#

如果需要使用首尾帧、参考视频、参考音频等 Seedance 多模态能力,可以额外新增一个 Seedance 渠道:
配置项填写内容
渠道协议Seedance 2.0 / SD2
Base URLhttps://api.naoshengyun.com/doubao/api/v3
API Key脑生云 API Key
Model ID手动填写,例如 doubao-seedance-2-0-260128
提示:该协议使用火山原生任务接口;如果模型目录无法同步,直接输入 Model ID 后按 Enter 添加即可。

验证#

渠道启用后,进入用户工作台“创作 Agent”,依次发送一条文本问答、一次生图和一次生视频请求;三类请求都能正常返回结果,即表示渠道配置成功。

三、视频创作(创作 Agent)#

图片、视频和文本问答统一在“创作 Agent”(/create)中完成,同一会话内可以连续生成和修改。

文生视频#

1.
登录 VOZEB PRO,进入“创作 Agent”。
2.
在输入框中描述想要的画面,例如:一只橘猫在阳光下的窗台上伸懒腰,电影感。
3.
关闭“智能规划”后,在模型下拉中选择脑生云视频模型;开启时由 Agent 自动选择模型与参数。
4.
按需设置比例、清晰度、时长和数量。
设置视频参数与参考方式
视频参数面板:设置参考方式、画面比例、清晰度和时长。
5.
点击发送,等待任务完成;生成过程中刷新或关闭页面不影响任务继续执行。
6.
结果返回后可以预览、下载原件,或保存到“我的素材”。
文生视频生成结果
文生视频任务完成后的结果预览。

图生视频#

1.
在“创作 Agent”输入框中上传或粘贴参考图片,也可以从“我的素材”中选择。
2.
选择参考方式:普通参考、首帧,或首尾帧。
3.
填写镜头描述,例如:镜头从清晨平滑过渡到黄昏。
4.
选择支持图生视频的模型,例如 wan2.7-i2v 或 doubao-seedance-2-0-fast-260128,点击发送。
图生视频生成结果
以参考图片和镜头描述生成视频后的结果预览。

先生图、再生视频#

1.
在同一会话中先描述画面,选择图片模型(如 gpt-image-2)生成关键帧。
在创作 Agent 中先生图
在“创作 Agent”中先用图片模型生成关键帧。
2.
选中满意的图片,作为参考素材继续发送视频生成请求。
3.
不满意的结果可以单独点击重试,不影响会话中的其他结果。

四、画布创作(Canvas)#

画布适合多素材、多步骤的创作,通过节点和连线把文本、图片、视频组织成一条完整的创作流程。

创建画布#

1.
进入“我的画布”(/canvas),点击“创建画布”。
2.
输入画布名称后打开 Canvas 编辑器;画布内容会自动保存到服务器。
新建画布
在“我的画布”页面点击“新建画布”。

文本节点:生成或优化提示词#

1.
在工具栏新建文本节点,双击节点写入创作想法。
2.
选中文本节点,点击顶部工具栏“编辑”,打开节点下方对话框。
3.
在对话框中选择脑生云文本模型,输入修改要求,例如:扩写为一段适合生成视频的分镜提示词。
4.
点击发送后,改写结果会生成在右侧新的文本节点中,并自动连线,原文本保留方便对比。
画布中的文本节点
画布中的文本节点、生成配置节点与右侧画布助手。

图片节点:从文本生成图片#

1.
选中已确认的文本节点,点击顶部工具栏“生图”。
2.
系统在右侧自动创建生成配置节点并连线,读取上游文本作为提示词开始生成。
3.
需要调整模型、比例或数量时,在生成配置节点中修改后再次生成。
4.
数量大于 1 时,会在右侧继续生成对应数量的子图节点。
image.png
文本节点经生成配置节点产出图片,节点之间自动连线。

视频节点:从文本 / 图片生成视频#

1.
从文本节点、图片节点或生成配置节点发起视频生成,系统会在右侧生成新的视频节点并自动连线。
从图片节点发起视频生成
在图片节点上选择“引用该节点生成 → 视频生成”。
2.
生成配置节点切换为视频模式后,会读取上游文本作为提示词、上游图片作为参考图、上游视频作为参考视频。
生成配置节点可在图片、文本、视频和音频类型之间切换。
3.
在生成配置节点中选择脑生云视频模型,设置比例、清晰度和时长后开始生成。
4.
生成完成的视频可在节点内直接播放、暂停和拖动进度。

Canvas Agent 一键编排(可选)#

1.
在画布中摆放好文本、图片等节点并完成连线。
2.
启动 Canvas Agent Run,Agent 会读取当前画布与选区,自动规划图片、视频子任务。
3.
生成结果会回填为对应节点;任务支持暂停、恢复、取消和失败重试。

推荐流程#

1.
新建文本节点,写入视频创作想法。
2.
用文本模型优化提示词,生成新的文本节点。
3.
点击“生图”生成关键帧图片。
4.
以关键帧图片为参考,生成视频节点。
5.
预览满意后下载,或保存到“我的素材”继续使用。

注意事项#

一个生成任务只会调用一次上游创建接口;任务明确失败后需要用户主动点击重试,才会重新提交,避免重复扣费。
视频模型只接受上游可访问的素材地址;VOZEB PRO 会为站内素材生成短期签名地址,无需手动上传到公网。
模型下拉中看不到脑生云模型时,请管理员检查渠道是否已启用、模型是否已同步为逻辑模型。
文本、图片和视频是不同类型的模型;只有 API Key 已开通相应模型时,才能在对应入口调用。

常见问题#

问题处理方式
同步模型失败或目录为空检查 Base URL 是否为 https://api.naoshengyun.com/v1、API Key 是否有效;也可以直接手动输入 Model ID
提示“积分不足”联系管理员在“用户运营”中补充积分,或在“充值中心”购买套餐
视频任务长时间排队视频为异步任务,生成时间与模型、时长和清晰度相关;可在脑生云控制台“使用日志”中核对调用状态
图生视频不生效确认所选模型支持图生视频(如 i2v 系列或 Seedance),并检查参考图是否设置为首帧
修改于 2026-10-28 05:52:04
上一页
百度搭子
下一页
VOZEB 本地启动教程
Built with