Appearance
额度和计费
MoonApiX 的费用通常由模型、动作、分辨率、时长、生成数量和任务状态决定。实际费用以 MoonApiX 后台展示和接口返回为准。
常见计费维度
| 能力 | 常见维度 |
|---|---|
| 文本、聊天、视觉理解 | 按模型和用量计费。 |
| 图片生成 | 按模型、尺寸和生成数量计费。 |
| 视频生成 | 按模型、时长、比例、分辨率或生成数量计费。 |
| 素材资源 | 托管 URL、素材 ID 和生成任务分别计费。 |
| 数字人 | 形象、音色、音频和视频任务按对应模型或动作计费。 |
| 音乐 / Suno | 音乐、歌词、音效和后处理任务按模型或动作计费。 |
任务状态和扣费
| 状态 | 说明 |
|---|---|
pending / submitted / running | 任务正在处理，请等待最终状态。 |
succeeded | 任务完成，按任务规则计费。 |
failed | 任务失败时，以后台最终记录为准。 |
cancelled | 已取消任务的费用规则以后台展示为准。 |
素材费用边界
| 动作 | 何时发生 | 计费模型 |
|---|---|---|
| 托管 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 创建费用。
mode=both 会同时尝试创建 MoonApiX 托管 URL 和模型素材 ID，可能分别触发 asset_upload_oss 与 asset_create_media 计费；只有同时需要这两类结果时才使用。
接入建议
- 提交任务前确认账号余额、额度和模型权限。
- 保存每次请求返回的
task_id，用于查询状态和核对费用。 - 长任务建议使用 Webhook，同时保留主动查询逻辑。
- 批量任务建议记录模型名、生成数量、时长和最终状态。