中文 · English · 日本語

🧋 Seedacne × Dots

在 Dots 里说一句需求，让你自己的视觉创作 Agent 交回真实的图片和视频

这个仓库是一份交给 Codex 执行的接入模板。把下面那段话发给 Codex，它会帮你开好自己的火山方舟 Agent，部署一个只有你能访问的私有 MCP 服务，再把它接进 OpenAI Dots。之后你在 Dots 对话里提需求、附参考图、在原会话里接着改，再拿回成品。

Seedacne 是本项目对火山方舟 Seedance Managed Agent 的叫法，控制台、API 和代码标识里看到的都是 Seedance。这是非官方示例，账号、Key、费用都是你自己的，仓库里不含任何人的凭据，也不提供共用服务。

📦 安装

用有终端、浏览器或 computer use 能力的 Codex，发这段话：

请按 https://github.com/LearnPrompt/seedacne-dots 的 AGENTS.md 和 docs/setup-prompt.md，实际帮我配置我自己的 Seedacne Managed Agent，并通过私有 Sites MCP 接入 OpenAI Dots。
先检查当前官方文档、可用工具和我的账号权限，复用本仓库源码。继续完成必要的检查、开发、私有部署和只读验证；把确实需要本人操作或授权的事项集中标出，已授权同一范围的动作不要重复询问。
默认不提交素材生成、不充值或购买服务。先把不花生成费的接入工作做完，再给我一次 5 秒视频测试的具体方案与授权点。

想看 Codex 会照着做什么，读完整接入提示词，也有纯文本版。

Related MCP server: PicMovi Photo to Video MCP

✅ 开始前确认

这几样缺一样都接不通，建议先花一分钟看完。

🧭 接下来会发生什么

第一步，Codex 干活。 它检查账号资格，创建或复用 Agent 和云端 Environment，部署私有 MCP，这时生成开关默认是关的。

第二步，你点头。 只有碰到这些才需要你：本人登录和验证码、接受具体服务协议、创建专用 Key 并写入私有服务、确认插件新增权限、付款或首次付费生成。每项确认什么、怎么回复，都在授权清单里。

第三步，在 Dots 实测。 先做只读连接检查，确认读得到你自己的 Agent 和 Environment。你明确授权后再提交一次测试，保持同一个 request_id 查询，下载实际 MP4 检查参数和画面。超时也不换编号重发，否则可能重复扣费。

测试提示词在案例文档里，把 request_id 换成你自己的新编号再用。

🧋 真实跑了一次

一次 5 秒奶茶视频，从 Dots 提交到收到 MP4，全程没有重新生成。

拿到视频和画面达标是两件事，要分开验收。 一次任务可能调用多个模型和工具，模板没有金额硬上限，一次提交也不是固定总价。

完整测量和 SHA-256 见实测案例与媒体元数据。

v0.2 另外实测了参考图上传，以及在同一个 Session 里接着改一轮。这一轮修改用的是代码蒙版，没有调用生成式改图，所以只证明续接这条路通了，图片质量仍有偏差，见验证记录。

⚙️ 工作原理

flowchart LR
  A[Dots 对话] --> B[你的私有 MCP 插件]
  B --> C[方舟 Managed Agents API]
  C --> D[Session]
  D --> E[实际图片 / 视频]

🚧 边界

• 只能跑在 Sites 上。 模板信任网关注入的 oai-authenticated-user-id，这个请求头目前查不到公开文档。换平台必须自己实现等价的认证和用户隔离，直接部署到公网，身份可以被伪造。

• 只有北京地域验证过。 接口地址写死为方舟中国北京 API，换地域不是改个域名的事。

• 参考图只收 JPEG、PNG、WebP。 单图最多 10 MiB，每轮最多 6 张；音频、视频参考和独立的时长、分辨率参数还没做。首次传图会被拦截并显示下载域名，核验后加进 REFERENCE_ALLOWED_HOSTS。

• Agent 停在 requires_action 时无法接着处理。 工具会如实报告，后续要自己去方舟排查。

• 单次提示词上限 12,000 字。 超过时任务不会提交。

🔬 开发与验证

需要 Node.js 24 或更高版本，没有第三方运行依赖。

npm run check

这条命令跑全部离线测试、构建、产物检查、相对链接与隐私扫描，不访问方舟，也不生成素材。

本地通过、线上只读通过、Dots 实际生成、素材质量，是四项独立的结果，一项通过不代表下一项也过了。

创建个人实例时，复制到独立目录，排除 .git、构建产物和凭据。个人部署配置不要推回这个公开仓库。

📚 文档

🌟 致谢

接入流程基于官方的方舟视觉创作 Agent、Dots、Sites 和 MCP 服务文档。README 版式参考了 khazix-skills。

代码 MIT · assets 里的媒体不在 MIT 范围内

Made by @LearnPrompt