计费

MoonApiX 的费用通常由模型、动作、分辨率、时长、生成数量和任务状态决定。实际扣费金额以 MoonApiX 后台展示和接口返回为准。

计费方式

能力	常见计费维度
文本、聊天、视觉理解	按模型和用量计费。
图片生成	按模型、尺寸和生成数量计费。
视频生成	按模型、时长、比例、分辨率或生成数量计费。
素材资源	托管 URL、素材 ID 和生成任务分别计费。
数字人	形象、音色、音频和视频任务按对应模型或动作计费。
音乐 / Suno	音乐、歌词、音效和后处理任务按模型或动作计费。

任务状态和扣费

状态	说明
queued / running	任务正在处理，请等待最终状态。
succeeded	任务完成，按任务规则计费。
failed	任务失败时，以后台最终记录为准。
canceled	已取消任务的费用规则以后台展示为准。

如果同一个任务支持重试，建议保存原始 task_id、请求参数和重试后的新 task_id，便于核对结果。

素材计费边界

素材相关费用按显式动作产生：

动作	何时发生	计费模型
托管 URL 创建	调用 /v1/assets/uploads 且 mode=oss 或 mode=both，成功创建 MoonApiX 托管 URL。	asset_upload_oss
模型素材 ID 创建	调用 /v1/assets/uploads 且 mode=asset 或 mode=both，素材状态变为 ready。	asset_create_media
视频生成	调用视频生成接口并创建任务。	对应视频模型价格。

直接在生成请求中传客户自己的公网 URL，不会产生 MoonApiX 托管 URL 创建费用。二进制文件按生成接口要求直接提交，也不等同于创建 MoonApiX 托管 URL。

mode=both 会同时尝试创建 MoonApiX 托管 URL 和模型素材 ID，可能分别触发 asset_upload_oss 与 asset_create_media 计费；只有同时需要这两类结果时才使用。

视频任务的结果地址形态以接口响应为准。请在业务系统中保存最终 URL 和原始响应，方便后续查询和核对。

查询建议

• 在提交任务前确认账号余额、额度和模型权限。
• 保存每次请求返回的 task_id，用于查询状态和核对费用。
• 长任务建议使用 Webhook，同时保留主动查询逻辑。
• 批量任务建议在业务系统中记录模型名、生成数量、时长和最终状态。

后台信息

MoonApiX 后台会展示账号余额、模型权限和可用额度。文档中的价格描述只用于说明规则，具体金额请以后台当前配置为准。