AI 助手接入（Claude Code / Codex）
在对话中找模型、估价、生成图片、视频和音频，并把结果保存到本地。
同样的模型，同样的价格；独立预算，随时撤销；超过设定金额先询问。
三步开始
登录接入页创建连接，设置预算、单次预估上限和询问阈值；复制对应助手的命令；重启助手，等待页面显示已连接。
以下示例仅适用于主站。租户用户应复制自己站点接入页生成的命令。凭证只显示一次，遗失后请撤销并重新创建。
Claude Code（Windows PowerShell / macOS / Linux）
claude mcp add --scope user --transport http seedance https://api.seedance.nz/mcp --header "Authorization: Bearer <AGENT_TOKEN>"
运行后重新打开 Claude Code，可用 /mcp 查看连接状态。
Codex（Windows PowerShell）
setx SEEDANCE_AGENT_TOKEN "<AGENT_TOKEN>"
$env:SEEDANCE_AGENT_TOKEN = "<AGENT_TOKEN>"
codex mcp add seedance --url https://api.seedance.nz/mcp --bearer-token-env-var SEEDANCE_AGENT_TOKEN
Codex（macOS / Linux）
export SEEDANCE_AGENT_TOKEN="<AGENT_TOKEN>"
echo 'export SEEDANCE_AGENT_TOKEN="<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。
开发者信息
MCP: https://api.seedance.nz/mcp
Authorization: Bearer <AGENT_TOKEN>
工具与主要参数
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 表示上游结果不确定，不要自动重新生成。