Seedance MA 详解：火山方舟视觉 Agent 怎么开通、调用和计费

据快科技 10 月 21 日报道，字节跳动旗下火山引擎上线 Seedance Managed Agent（Seedance MA），这是一个基于 Seedance 视频模型和 Seedream 图像模型的视觉创作 Agent。下半篇按火山方舟官方文档，讲清怎么开通、怎么调、怎么计费。用法部分基于官方文档整理，未实测；文中效果数字都是火山引擎自报。

发生了什么

分工上，自研 Harness 负责理解意图、拆任务和管上下文，Skills 沉淀创作流程，多模态模型负责生成，工具负责检索、合成和核查。官方给的细分数字是：短剧剧本与分镜未遵循问题减少约 67%，图片编辑一致性问题减少 50%，组图一致性问题减少 60%。电商详情图场景能按长页面输出纵向长图，而不是固定 9:16。

这和 Anthropic 的 Claude Managed Agents 是一个思路：厂商不只卖模型，而是把「模型 + Harness + Skills」打包成托管 Agent 卖。入口在火山方舟控制台的 Managed Agents，创建时选 Seedance Managed Agent，再配工具、知识库和素材。

注意：提升幅度都是官方自报，没有公开评测方法，下文单独说明怎么看。我们没有实测。

它解决的是「串接口」的脏活

官方文档的场景说明讲得很实在：做营销素材通常要检索素材、做主视觉、生成视频、存产物；如果直接串图片和视频生成 API，业务系统还得自己处理提示词拆解、任务轮询、文件转存和失败重试。Seedance MA 把这些交给 Agent 来做。

官方说的效果提升，怎么看

上面那组数字出自火山引擎发布稿（官网未见单独新闻页，我们看到的是品玩等媒体的全文转载）：和直接用模型相比，短剧、图片和组图场景综合质量提升 17%，剧情混乱问题减少约 54%。

这些都是厂商自测，发布稿没有公开评测集、评测方法和对照模型版本，目前也没有第三方复现。

开通：四样东西先备齐

按官方「快速入门（控制台）」和教程的前置条件：

• 在 API Key 管理页创建 API Key，只放在服务端。
• 在开通管理页切到 Managed Agents 页签，开通 Managed Agents 服务。
• 按控制台提示开通 Seedance Managed Agent 使用权限。没开通就创建，会返回 403 OperationDenied。
• 开通主模型、图片生成和视频生成模型服务，以及视觉搜索等工具服务。可选模型以控制台 Seedance MA 创建页展示的为准。

路线一：在控制台里点出来

登录火山方舟控制台，进入 Managed Agents 模块：

• 在 Agents 页面点「创建 Agent」，Agent 版本选「Seedance Managed Agent」，选模型、写系统提示词，按需挂 Skills（火山 SkillHub 预置或本地上传）、Tools 和 MCPs（以 URL 接入远程 MCP Server）。保存后得到稳定的 agent_id，修改会生成新版本，支持回滚和灰度发布。
• 在 Environments 页面创建 Environment，类型目前只有「云托管」；可选预装 pip、apt 依赖、环境变量和产物存储（自有 TOS 目录，需与服务同地域；不选就用方舟公共 TOS，要在 TTL 到期前下载）。
• 在 Sessions 页面创建 Session，绑定 Agent 和 Environment，在会话面板输入需求或上传附件，在事件时间轴（Trace）看思考、工具调用和重试，结束后看产物、耗时、Token 消耗和工具调用次数。

路线二：用 API 跑通官方示例

官方教程用「城市精品咖啡新品宣传」举例：先出一张 16:9 主视觉，再以它为首帧生成 4 秒视频。环境变量（模型 ID 是文档示例，换成你控制台里可选的）：

export ARK_API_KEY="<YOUR_API_KEY>"
export ARK_BASE_URL="https://ark.cn-beijing.volces.com/api/v3"
export AGENT_MODEL_ID="doubao-seed-2-1-lite-260915"
export IMAGE_MODEL_ID="doubao-seedream-5-0-pro-260628"
export VIDEO_MODEL_ID="doubao-seedance-2-5-260628"

创建 Agent 是 POST $ARK_BASE_URL/agents，关键字段如下（节选自官方示例，完整脚本见文档）：

{
  "name": "visual-creation-agent-demo",
  "model": {"id": "$AGENT_MODEL_ID", "reasoning_effort": "high"},
  "base_agent": "ultra_vision_agent_preview",
  "tools": [
    {"type": "agent_toolset_20260916",
     "default_config": {"enabled": true},
     "configs": [{"name": "web_search", "enabled": false}]},
    {"type": "agent_toolset_multimodal_20260825",
     "default_config": {"enabled": false},
     "configs": [
       {"name": "image_generate", "enabled": true, "models": [{"id": "$IMAGE_MODEL_ID", "default": true}]},
       {"name": "video_generate", "enabled": true, "models": [{"id": "$VIDEO_MODEL_ID", "default": true}]},
       {"name": "visual_search", "enabled": true},
       {"name": "general_search", "enabled": true},
       {"name": "compose_video", "enabled": true},
       {"name": "todo_write", "enabled": true}]}
  ]
}

后面三步：POST /environments 建云端环境（示例用 networking unrestricted，官方说生产环境要收敛网络策略）；POST /sessions 绑定 agent 和 environment_id，新会话状态是 idle；先打开 GET /sessions/{id}/events/stream 的 SSE 事件流，再 POST /sessions/{id}/events 发一条 user.message。事件流里会看到 GenImage、GenVideo 等工具调用，收到 session.status_idle 才算这一轮结束。产物写在 /mnt/session/outputs/，用 GET /files?scope_id={session_id} 拿临时下载地址。

配置的硬约束

• base_agent 必须是 ultra_vision_agent_preview，创建后不能改。
• reasoning_effort 固定 high，填别的值返回 400 InvalidParameter。
• 基础工具集和多模态工具集都要挂；image_generate、visual_search、general_search、compose_video 必须启用，video_generate 和 todo_write 可选。
• 开了 general_search 就必须关掉基础工具集里的 web_search。
• 每个生成工具最多绑 10 个模型，绑多个时只能有一个默认。

钱花在哪

官方价格页写明 Seedance MA 不新增独立计费项，费用 = 模型调用 + Agent 运行时 + 工具调用：图片和视频生成按实际调用的模型和规格计费；运行时只在 Session 处于 running 时计费，0.5 元/小时，idle 等待时不计；general_search、visual_search 各 0.02 元/次，compose_video 限时免费。Managed Agents 首次开通送 30 小时运行时和 500 次 web_search，每个账号一次，有效期 2 年。大头通常在视频生成本身，按 Seedance 模型的 token 价格算。

官方给的省钱做法：先出一张候选图确认构图和风格再出视频；视频草稿先用短时长、低分辨率；已有明确参考素材时别让它再搜；在系统提示词里限定文件数量和文件名；用 SSE 等终态，不要重复发消息催，收到 session.error 也别直接重提，以免重复扣生成费。

谁适合用

它面向企业和开发者，通过 Agent API 接入自己的内容平台、素材系统、审核与发布流程，适合短剧、品牌广告、电商详情图这类需要「剧本—分镜—出片—拼接」长链路的团队。官方举的例子是营销团队从历史广告片里检索可用镜头和参考图，用在新脚本和分镜上。个人创作者目前没有现成的消费级界面，控制台更像调试台。

常见坑

• 只看文字回复判断完成：官方说要以 session.status_idle 为准，Files API 注册产物有短暂延迟，要轮询。
• 产物丢失：用公共 TOS 时要在 TTL 前下载；download_url 是临时地址，不能当长期链接存。用完按 Session → Agent → Environment 的顺序清理。
• 模型 ID 对不上：示例 ID 不一定在你的控制台出现，以创建页可选模型为准。

最后

已经在用 Seedance 出片的团队，可以拿一条真实的营销需求，分别直接调模型和交给 Seedance MA，比一比返工次数和总花费，再决定要不要把它接进生产流程。