01 / QUICK START

快速开始

02 / ACCOUNT

账号与数据同步

• 注册使用手机号验证码、唯一账号名称和密码。每个账号会获得稳定用户 ID，用于账户核验和后台管理。
• 项目、资产、模板、Agent 历史、短视频项目和发布任务会按账号安全保存。
• 首次登录会把旧版浏览器本地数据迁移到当前账号；之后在其他设备登录同一账号即可恢复云端数据。
• 豆包账号管理器登录当前萤琉账号后，会把豆包账号资料和登录 Cookie 写入按用户隔离的加密会话保险库。其他设备登录同一萤琉账号即可恢复仍有效的豆包会话；会话过期或触发豆包设备验证时仍需重新登录。
• 头像上传会经过服务端视觉审核；审核模型未配置时不会保存新头像。

03 / WORKFLOW

创作工作流

04 / AGENT

Agent 使用说明

• 首页 Agent 支持剧本创作、图片生成和视频生成三种模式，上传图片时会作为视觉参考提交。
• 开启联网搜索后，资料、政策、价格、推荐和研究类需求会先检索网页，再结合来源回答。
• 图片生成会优先使用用户原始需求；继续修改“上一张图”时，会自动复用最近生成图作为参考。
• 每轮对话可引用最多 3 条历史消息；生成图片可一键引用到下一轮附件。

05 / SHORT VIDEO

短视频一条龙

• /short-video 覆盖选题、文案、分镜、角色资产、分镜图、图生视频、配音、字幕、自动剪辑、导出 MP4、封面和发布包。
• 新建项目时填写或由 AI 生成的项目标题会直接作为本项目自定义选题，创建后进入原创文案步骤。
• 真实模式的模型在文案、分镜、资产、生图、生视频、配音、封面和发布包等对应步骤中分别选择；创建项目时无需一次性配置全流程模型。
• 新建项目可多选已有 IP：第一个选中的 IP 作为主 IP 继承默认音色，资产提取和分镜图生成会复用所有已选 IP 的主形象。
• 基础资产会按剧本提取多个角色 / 其他形象、场景和道具；使用 IP 时只复用 IP 主角，剧本里的其他形象仍会单独提取和生成。
• 生成基础资产、分镜图、视频片段或封面时不会自动调用视觉质检模型；需要模型质检时，点击当前页面的“运行智能质检”一次性检查本阶段全部内容，也可人工确认后进入下一阶段。
• 自动剪辑支持中文字幕、配音、音乐和成片导出。
• 发布中心只使用官方 OAuth 和开放接口，不保存平台密码、短信验证码或 Cookie。

06 / RELAY PLUGINS

中转插件制作说明

中转插件是一个声明式 JSON 文件，用来告诉平台“如何请求你的中转站、如何读取结果”。插件不包含可执行脚本；用户安装后再单独填写 Base URL、API Key 等配置。

安装与使用

1. 先阅读中转站的模型、鉴权、生成接口和任务查询文档。
2. 下载平台提供的 示例插件 JSON，修改插件信息、模型和 operation。
3. 在主站右上角打开“中转插件”，选择 JSON 文件或粘贴内容，校验后安装。
4. 填写插件要求的配置项并保存；已启用插件内的模型会自动出现在各模块模型选择器中。

本地版分类目录

• plugins/text 存放仅声明文本模型的插件。
• plugins/image 存放仅声明图片模型的插件。
• plugins/video 存放仅声明视频模型的插件。
• plugins/multimodal 存放视觉、语音或同时声明多种能力的插件。
• 旧版位于 plugins 根目录的有效 JSON 会在首次扫描时自动迁移；分类放错的插件不会加载，并会在中转插件面板显示错误路径。

顶层字段

最小文本插件

{
  "schemaVersion": 1,
  "id": "my.relay",
  "name": "我的中转",
  "version": "1.0.0",
  "baseUrlConfigKey": "baseUrl",
  "configFields": [
    {"key":"baseUrl","label":"Base URL","type":"url","required":true},
    {"key":"apiKey","label":"API Key","type":"password","required":true}
  ],
  "models": [
    {"id":"my-model","name":"My Model","capability":"text","operation":"chat"}
  ],
  "operations": {
    "chat": {
      "request": {
        "method":"POST",
        "path":"/chat/completions",
        "encoding":"json",
        "auth":{"type":"bearer","configKey":"apiKey"},
        "body":{
          "model":"{{model}}",
          "messages":[{"role":"user","content":"{{prompt}}"}]
        }
      },
      "response":{
        "valuePaths":["choices.0.message.content"],
        "errorPaths":["error.message","message"]
      }
    }
  }
}

模板变量

字符串中的 {{变量}} 会在请求时替换。整项只有一个模板变量时会保留数组、对象、数字等原始类型。常用变量如下：

把参考图数组转换为对象数组

当上游接口要求每张参考图都是 {"url":"...","role":"..."} 对象时，可在请求体中使用声明式 $map。from 必须渲染为数组，as 是单项变量名，indexAs 可选；template 定义每一项的输出结构：

"images": {
  "$map": {
    "from": "{{referenceImages}}",
    "as": "referenceImage",
    "indexAs": "referenceIndex",
    "template": {
      "url": "{{referenceImage}}",
      "role": "reference_image"
    }
  }
}

role 的具体枚举值必须以中转站文档为准。未提供参考图时，上述映射会生成空数组；平台仍会依据模型的 supportedGenerationModes 和 maxReferenceImages 控制选择方式与数量。

同一接口在不同生成模式下需要不同字段值时，可使用声明式 $switch。例如图生视频把参考图声明为首帧，多参考模式则声明为普通参考图：

"role": {
  "$switch": {
    "value": "{{generationMode}}",
    "cases": {
      "image-to-video": "first_frame"
    },
    "default": "reference_image"
  }
}

请求、鉴权与响应

• request.method 支持 GET、POST、PUT、PATCH、DELETE；encoding 支持 json、form、none。
• request.path、query、headers 和 body 均可使用模板变量。完整 URL 只能与 Base URL 同源，不能借插件跳转到其他主机。
• auth.type 支持 bearer、header 和 query。可用 header、prefix、name、configKey 适配不同签名位置。
• response.valuePaths 按顺序读取第一个非空结果；路径使用点号访问对象和数组，例如 data.0.url。
• response.errorPaths 定义错误信息字段。上游返回非 2xx 时，平台会读取这些字段展示给用户。

异步任务轮询

如果提交接口先返回任务 ID，可在提交响应中配置 taskIdPaths，并给 operation 添加 poll：

"response": {
  "valuePaths": ["video.url"],
  "taskIdPaths": ["task_id", "id"]
},
"poll": {
  "method": "GET",
  "path": "/tasks/{{taskId}}",
  "intervalMs": 5000,
  "maxAttempts": 120,
  "response": {
    "valuePaths": ["result.video_url"],
    "statusPaths": ["status"],
    "failedValues": ["failed", "error", "cancelled"],
    "errorPaths": ["error.message", "message"]
  }
}

能力与模型参数

• capability 可为 text、vision、image、video 或 speech。当前主站插件调用链覆盖文本、视觉质检、图片和视频；语音插件调用链尚未开放。
• 图片或视频模型可声明 supportedResolutions、supportedAspectRatios、supportedDurations、supportedGenerationModes 和 maxReferenceImages，平台会据此限制界面选项。
• 不要把真实 API Key 写入插件 JSON。密钥应只作为 password 类型配置字段，由每位用户安装后自行填写。