运营操作手册
本文面向后台运营账号，说明日常如何操作额度管理、凭证管理、用户管理、用量查询和火山方舟资源自动开通。 页面中能看到的功能取决于管理员给该运营账号开启的权限。
权限与资源归属
| 概念 | 说明 |
|---|---|
| 自己创建 | 当前运营账号创建的凭证、额度规则、用户、同步配置、自动开通记录。通常可以编辑和删除。 |
| 管理员分配 | 管理员把凭证或其他资源分配给运营。运营可以用于额度检查、自动开通等操作，但不能查看 SK 明文。 |
| 只读资源 | 不是当前运营创建且没有“管理全部”权限的资源。可以查看，部分模块允许同步、重置、查看任务。 |
| 管理全部 | 管理员给运营单独开启的高级权限，例如凭证-管理全部、用户-管理全部、同步配置-管理全部、火山开通-管理全部。 |
凭证管理
保存凭证
- 进入「凭证管理」。
- 填写名称、Access Key、Secret Key、Project Name、类型和备注。
- 点击「保存凭证」。Secret Key 会加密保存在服务端。
使用管理员分配的凭证
如果凭证由管理员分配给你，你可以在额度管理或自动开通里选择使用，但凭证管理列表中会显示为只读，不能编辑、删除或查看 Secret Key。
额度管理
查询 Endpoint
- 在「API 配置」里选择已保存凭证，或手动输入 AK/SK。
- 点击「查询 Endpoint 列表」。
- 在目标 Endpoint 行点击「配置」，页面会自动跳到额度配置表单。
配置额度规则
- 填写名称、备注、Endpoint ID。
- 按需要填写每日/月 Token 限额或金额限额；0 表示不限制。
- 选择关联凭证。该凭证用于后端定时检查和启停 Endpoint。
- 填写 Ark API Key。它用于同步任务和计算消耗。
- 如需按日/月限额自动停用，勾选「到限额自动停用」。用户余额耗尽触发的停用不依赖这个开关。
- 点击「保存额度配置」。
已配置的额度规则
| 操作 | 用途 |
|---|---|
| 搜索 | 按名称、Endpoint ID、备注过滤当前可见规则。 |
| 编辑 | 只对自己创建的规则显示。用于修改限额、备注、凭证、Ark API Key。 |
| 同步 | 从 Ark 任务接口同步任务并刷新当前用量。只读规则也可同步。 |
| 重置 | 把当前日/月用量归零，并写入历史记录。只读规则也可重置。 |
| 任务 | 打开该规则对应 Endpoint 的任务列表。 |
| 删除 | 只对自己创建的规则显示。 |
用户管理
创建普通用户
- 进入「用户管理」，点击「新建用户」。
- 填写用户名、显示名称、密码。
- 给用户选择可查看的同步配置和文档。
- 如需素材测试，配置素材测试所需的 AK/SK、Ark API Key、Endpoint、Asset Group 和 TOS 信息。
充值与余额
普通用户余额 = 累计充值 - 已同步任务消耗。给用户充值后，系统会按用户的余额检查间隔刷新消耗；余额恢复为正数时，会尝试恢复关联 Endpoint。
短信通知
如果用户配置了手机号和预警额度，系统会在余额低于阈值或耗尽时通过已配置短信通道发送通知。
用量查询
直连任务
用于查看 Ark API Key 直接创建的视频任务。可以选择 API Key、Endpoint/Model、日期范围、状态和分辨率。点击「从 API 同步」会从 Ark 拉取任务并写入本地库。
中转站任务
用于查看 Relay 代理产生的任务和日志。可按中转账户、Endpoint、任务 ID、状态、日期范围查询。
同步配置
用于维护 API Key 与 Endpoint/Model 的同步关系。新建同步配置后，系统可定时同步任务并计算金额。
金额口径
总金额基于已同步任务、模型/分辨率、计费倍率计算。失败任务是否计入以当前任务同步和计费规则为准；如发现差异，先检查任务状态、时间范围、API Key 和 Endpoint/Model 是否选对。
火山方舟资源自动开通
- 进入「凭证管理」下方的「火山方舟资源自动开通」。
- 选择管理凭证。管理员分配的凭证可以使用，但不会显示 SK。
- 填写开通名称、Project Slug、ProjectName、系统策略名和 Seedance 模型。
- 先点击「权限预检」，确认 IAM、Ark、Project、Endpoint 权限满足要求。
- 点击创建后，后台会创建 IAM 子用户、Project、策略、Endpoint 和 Ark API Key。
- 如果 Ark API Key 没返回明文，可从火山控制台复制后点击「补录 API Key」。
- 成功后可点击「导出 TXT」，交付 Project Name、AK、SK、Ark API Key 和 Endpoint。
日常检查清单
- 新客户开通后，确认凭证、Project Name、Ark API Key、Endpoint 已保存。
- 在额度管理中为 Endpoint 建立规则，并绑定正确凭证和 Ark API Key。
- 在同步配置里确认 API Key、Endpoint/Model、计费倍率正确。
- 给普通用户绑定正确同步配置，并设置余额检查间隔。
- 运营交付前，用用量查询确认任务能同步，金额能统计。
常见问题
看不到凭证
确认管理员是否给你的运营账号分配了凭证，并确认你的账号有额度管理、自动开通或凭证管理权限。
能选择凭证但看不到 SK
这是正常行为。管理员分配的只读凭证会由后端使用，不会在前端显示 Secret Key。
额度规则不能编辑或删除
该规则不是当前运营创建。你仍可同步、重置、查看任务；需要编辑时请联系管理员或原创建人。
Endpoint 查不到
检查凭证是否属于正确 Project、Project Name 是否填写正确、Endpoint 是否在对应账号和区域中。
用户额度不更新
先在用户页面或后台触发同步/刷新消耗；再检查同步配置是否绑定给用户、任务是否已同步、计费倍率是否正确。
短信没有发送
检查短信通道配置、模板参数、用户手机号、短信开关和预警额度。余额从正常变为预警或耗尽时才会触发通知。