# AI 助手接入（Claude Code / Codex） 在对话中找模型、估价、生成图片、视频和音频，并把结果保存到本地。 AI 助手使用流程 同样的模型，同样的价格；独立预算，随时撤销；超过设定金额先询问。 ## 三步开始 登录接入页创建连接，设置预算、单次预估上限和询问阈值；复制对应助手的命令；重启助手，等待页面显示已连接。 [AI 助手接入](https://api.seedance.nz/console/agent-connect) 以下示例仅适用于主站。租户用户应复制自己站点接入页生成的命令。凭证只显示一次，遗失后请撤销并重新创建。 ### Claude Code（Windows PowerShell / macOS / Linux） ```sh claude mcp add --scope user --transport http seedance https://api.seedance.nz/mcp --header "Authorization: Bearer " ``` 运行后重新打开 Claude Code，可用 /mcp 查看连接状态。 ### Codex（Windows PowerShell） ```powershell setx SEEDANCE_AGENT_TOKEN "" $env:SEEDANCE_AGENT_TOKEN = "" codex mcp add seedance --url https://api.seedance.nz/mcp --bearer-token-env-var SEEDANCE_AGENT_TOKEN ``` ### Codex（macOS / Linux） ```sh export SEEDANCE_AGENT_TOKEN="" echo 'export SEEDANCE_AGENT_TOKEN=""' >> ~/.zshrc codex mcp add seedance --url https://api.seedance.nz/mcp --bearer-token-env-var SEEDANCE_AGENT_TOKEN ``` Bash 用户将 ~/.zshrc 改为 ~/.bashrc。设置后关闭并重新打开终端，再启动 Codex。配置保存在 ~/.codex/config.toml。 ### 推荐安装使用技巧 接入页提供一键复制的下载命令。Claude Code 安装到 ~/.claude/skills/seedance/SKILL.md；Codex 安装到 ~/.agents/skills/seedance/SKILL.md。Skill 会提醒助手先估价、等待确认、上传本地文件并给出结果链接。 ## 能做什么 查找模型和参数、估价、生成图片和视频、生成语音与音乐、查看进度、上传本地文件、导入 HTTPS 素材、下载结果。OAuth 和画布编辑将在后续阶段提供。 ## 五段示例对话 ### 雨夜海报 用户：生成一张 16:9 的雨夜街景。 助手：先查询可用模型与参数，上传需要的本地文件，再估价。预估费用为 X（示意，实际以工具结果为准），是否确认？ 用户：确认。助手：提交生成并查询进度，完成后提供结果链接和网站作品链接。 ### 本地图片做视频 用户：把 ./product.png 做成 5 秒产品旋转视频。 助手：先查询可用模型与参数，上传需要的本地文件，再估价。预估费用为 X（示意，实际以工具结果为准），是否确认？ 用户：确认。助手：提交生成并查询进度，完成后提供结果链接和网站作品链接。 ### 批量头像 用户：生成四张风格不同的猫咪头像。 助手：先查询可用模型与参数，上传需要的本地文件，再估价。预估费用为 X（示意，实际以工具结果为准），是否确认？ 用户：确认。助手：提交生成并查询进度，完成后提供结果链接和网站作品链接。 ### 音乐 用户：生成一段 30 秒轻快的 lo-fi 音乐。 助手：先查询可用模型与参数，上传需要的本地文件，再估价。预估费用为 X（示意，实际以工具结果为准），是否确认？ 用户：确认。助手：提交生成并查询进度，完成后提供结果链接和网站作品链接。 ### 语音 用户：将这段欢迎词变成自然的语音。 助手：先查询可用模型与参数，上传需要的本地文件，再估价。预估费用为 X（示意，实际以工具结果为准），是否确认？ 用户：确认。助手：提交生成并查询进度，完成后提供结果链接和网站作品链接。 ## 费用与安全 助手使用网站相同模型和价格。连接预算独立于账户余额，两者都需要足够额度。单次上限和询问阈值作用于预估费用，实际结算可能不同；最终费用以用量记录为准。 不要分享或提交凭证、签名上传链接。怀疑泄露时立即撤销连接；已生成的作品保留。助手必须在收到用户同意后才携带确认凭证重试。 ## 常见问题 ### 为什么需要重启助手？ 助手会从启动环境读取服务器地址和凭证。 ### 在哪里查看生成结果？ 助手会返回结果链接和网页地址；同一条记录也会出现在生成记录中。 ### 为什么助手看不到工具？ 重启助手，并确认凭证和服务器地址属于本站。 ### 凭证无效时该怎么办？ 如果凭证复制不完整、已撤销、已过期或是在其他站点创建，请重新创建连接。 ### 预算不足时该怎么办？ 提高此连接的预算，并确认账户余额足以支付请求。 ### confirmation_required 是什么意思？ 预估价格超过了你的确认阈值。确认费用后，再让助手重试。 ### 为什么预估价格可能和最终扣费不同？ 部分模型按实际用量结算。使用日志中的最终扣费为准。 ### 如何上传本地图片？ 告诉助手本地文件路径，它会在请求前上传文件。 ### 可以在公司网络或代理下使用吗？ 助手必须能通过 HTTPS 访问本站，包括服务和上传地址。 ### 这个连接安全吗？ 每个连接都有独立预算和限制。凭证泄露后请立即撤销。 ### 可以使用 Claude Desktop 或 claude.ai 吗？ Claude Desktop 和 claude.ai 将在后续支持；目前支持 Claude Code 和 Codex。 ## 开发者信息 ```text MCP: https://api.seedance.nz/mcp Authorization: Bearer ``` ### 工具与主要参数 ```text get_account {} list_models {kind, query, limit} get_model_schema {model} estimate_cost {model, prompt, params, inputs, count} generate_image / generate_video / generate_audio {model, prompt, params, inputs, count, max_cost, idempotency_key, confirm_token} get_task {task_id, wait_seconds} list_tasks {limit} create_upload {filename, content_type, size_bytes} import_media_url {url, kind} ``` 完整参数以 tools/list 返回的 JSON Schema 为准。估价后提交生成会立即返回持久任务 ID；调用 get_task，wait_seconds 最大为 50，任务成功、失败或未知时停止轮询。重试同一请求必须使用同一个 idempotency_key；unknown 表示上游结果不确定，不要自动重新生成。