文档中心

AI MediaKit

开发指南

按项目或 API Key 分账

AI MediaKit 支持按项目和 API Key 归集工具调用产生的用量与费用。您可以根据业务隔离粒度选择分账方式，也可以先通过项目隔离业务，再在同一项目内通过 API Key 进一步区分应用、环境或开发者的成本。

核心概念

概念	描述
账号 Account	火山引擎账号（主账号）是火山引擎资源归属、资源使用计量计费的基本主体。火山引擎账号为其名下所拥有的资源付费，并对其名下所有资源拥有完全控制权限。
项目 Project	项目是火山引擎提供的资源归属与计费分账的基本单位。您可以为不同的业务线、产品或环境（开发、测试、生产）创建不同的项目。这是实现成本分摊、资源分组和权限管理的核心。
队列 Queue	队列是 AI MediaKit 中用于接收任务的实体，它将任务与项目进行绑定，从而将任务产生的费用正确地归属到对应的项目账单下。
API Key	API Key 是调用 AI MediaKit 服务时用于身份认证的唯一凭证。仅 IAM 通用 API Key 支持作为费用中心的分拆项，AI MediaKit 专用 API Key 不支持。

选择分账方式

分账方式	适用场景	配置方式	查看结果
按项目分账	不同客户、业务线或环境需要独立管理资源、任务和费用	创建项目和队列，提交任务时传入该项目下的 queue_id	在 AI MediaKit 控制台按项目查看用量，在费用中心按项目查看费用
按 API Key 分账	同一个项目下，不同业务应用、测试环境或个人开发者使用不同的 API Key	为各成本归属对象创建不同的 API Key，提交任务时在 Authorization 请求头中使用对应的 IAM 通用 API Key	在费用中心的分账账单中选择 API Key 作为分拆维度

如果您既需要跨业务隔离资源，又需要核算同一业务内部的成本，可以组合使用两种方式。例如，先为生产业务和测试业务分别创建项目，再在生产项目内为不同应用分配独立的 API Key。

按项目分账

按项目分账适用于需要同时隔离资源管理范围和费用的场景。例如，SaaS 平台可以为每个客户创建项目；企业也可以为不同业务线或生产、测试环境创建项目。

步骤 1：为每个成本归属对象创建项目

登录火山引擎控制台，进入项目管理页面。

单击新建项目。

输入能够标识成本归属对象的项目名称。例如，按客户分账时可以使用 customer-[您系统中的客户 ID]；按环境分账时可以使用 production 或 testing。

创建项目后，当您在 AI MediaKit 控制台顶部通过项目选择器切换项目后，整个控制台的视图和操作范围都将被限定在该项目内。您所看到的用量统计、任务管理、队列管理、基础配置（包含 AI MediaKit 专用 API Key 及回调配置）都将是该项目专属的，从而确保不同客户或业务之间的资源和配置是完全隔离的。

步骤 2：在项目中创建队列并获取 queue_id

每个项目会自动创建一个名为 default 的默认队列。您可以直接使用默认队列，也可以根据业务需要创建其他队列。

说明

每个账号下最多可创建 10 个队列（含默认队列）。

队列名称创建后不支持修改。

在控制台顶部的项目选择器中，选择目标项目。

单击左侧导航栏的队列管理。

单击新建队列并输入队列名称。

创建成功后，在队列列表中复制队列 ID，例如 q00a9731598092652e4a95292434198。

说明

建议在业务系统中保存成本归属对象与 queue_id 的对应关系，提交任务时根据当前客户、业务或环境读取正确的队列 ID。

步骤 3：提交任务时传入队列 ID

在任务提交 API 的请求体中传入目标队列的 queue_id。以下示例将画质增强任务归属到该队列所在的项目：

通过在请求中明确指定 queue_id，这个画质增强任务及其产生的所有费用，就会被记录在 q00a9731598092652e4a95292434198 队列关联的 customer-a 项目下。如果未传入 queue_id，系统会使用自动创建的默认队列。任务及其费用将归属到该默认队列所在的项目。

步骤 4：查看用量与账单

完成以上设置后，您就可以按项目查看用量和费用：

查看项目用量：进入 AI MediaKit 控制台用量统计页面，通过顶部的项目选择器切换项目。页面上展示的所有用量数据，都仅属于该项目。

按客户进行分账：进入火山引擎费用中心账单明细页面，消费数据会按“项目”维度进行分拆。您可以看到名为 customer-a、customer-b 等项目的独立消费金额。

按 API Key 分账

按 API Key 分账适用于同一个项目内存在多个成本归属对象的场景。例如，企业可以为不同业务应用、开发环境、测试环境或个人开发者分配不同的 API Key，并分别核算各 Key 产生的工具调用量和费用。

注意

仅支持将在访问控制（IAM）控制台创建的 IAM 通用 API Key 作为费用中心的分拆项，不支持在 AI MediaKit 控制台创建的专用 API Key。详见准备工作：获取并配置 API Key。

第 1 步：创建 IAM 通用 API Key

进入访问控制（IAM）控制台，为需要独立核算成本的应用、环境或开发者创建 API Key。

记录每个 API Key ID 与成本归属对象的对应关系。请勿在文档、日志或代码仓库中记录 API Key 的完整密钥。

第 2 步：提交任务时使用 API Key

提交任务时，在 Authorization 请求头中使用分配给该成本归属对象的 IAM 通用 API Key。以下示例使用该 API Key 提交画质增强任务：

第 3 步：在费用中心选择 API Key 分拆维度

进入费用中心的分账账单页面。如果尚未开通分账服务，请根据页面提示完成开通。

单击页面右上角的设置/查看分拆维度，将 AI MediaKit 的分拆维度设置为 API Key。

返回分账账单页面，筛选 AI MediaKit 相关账单，查看每个 API Key ID 对应的工具调用量和费用。

说明

分账服务开通后，新生成的账单明细才会生成对应的分账数据，数据最长可能延迟 2 天。分拆项中展示的是 API Key ID，不会展示完整密钥。有关分账账单字段和数据规则的说明，请参见分账账单。

常见问题

是否支持将队列从一个项目转移到另一个项目？如何操作？

支持。您可以更改队列所属的项目。操作步骤如下：

登录火山引擎控制台，进入项目管理页面。

找到您的目标项目（即您希望将队列转入的新项目，如 Project B），单击该项目的管理资源按钮。

单击资源转入按钮，选择需要转移的队列资源，即可将其从原项目（Project A）转移至当前的新项目（Project B）下。

将队列转移到新项目后，用量统计和账单会如何展示？

当您将一个队列从原项目（例如 Project A）转入新项目（例如 Project B）后，账单出账规则与控制台用量统计规则分别如下：

账单页面的展示情况：费用的归集以系统最终出账时刻队列当前所属的项目为准。若任务产生费用并在出账时，该队列已转移至 Project B，则这部分账单费用会记录在 Project B 之下。

AI MediaKit 控制台用量统计页面的展示情况：用量数据是以用户提交任务时队列所绑定的项目为准进行统计的。因此，在队列转移前（属于 Project A 时）提交的任务，其用量统计数据仍会留在 Project A 的统计视图中；队列转移后提交的新任务，用量才会统计到 Project B 中。

由于上述统计维度的差异，在队列跨项目转移后，有可能会出现 AI MediaKit 控制台特定项目下的统计用量与最终账单费用无法完全对应的情况，属于正常现象。

更换或删除 API Key 后，如何查看费用？

每个 API Key ID 是独立的分拆项。更换 API Key 后，新调用产生的费用归属到新的 API Key ID，历史费用仍归属到原 API Key ID。建议保留 API Key ID 与应用、环境或开发者的对应记录，以便后续核对账单。

最近更新时间：2026.10.09 15:39:46

这个页面对您有帮助吗？

有用

无用