音视频与音色

音视频任务创建后直接执行，并按实际用量结算。先读取目录，只有标记为开放的产品才能执行。

产品与费率

GET  /api/v1/billing/media/credit-catalog
POST /api/v1/billing/media/credit-estimates

费率试算仅用于展示，不创建订单、不扣积分，也不能作为扣费依据。正式任务按服务端测得的实际用量扣费。

创建任务

POST /api/v1/media-jobs
Idempotency-Key: unique-request-id

产品类型：

product	用途
asr	语音识别
tts	语音合成
subtitle_translation	音视频字幕翻译
basic_video	基础视频处理
full_video	完整视频处理

语音识别示例：

{
  "product": "asr",
  "document_id": "4q8mx2q9z1k7p6ra",
  "source_language": "auto",
  "max_duration_ms": 600000
}

服务端检查文件后直接开始处理：开始前按时长门槛检查余额，不足时返回 402，不会开始收费处理；完成后按实际时长扣费，最多不超过开始时的可用余额。

查询和取消

GET  /api/v1/media-jobs/{operation_id}
GET  /api/v1/media-jobs?limit=25
POST /api/v1/media-jobs/{operation_id}/cancel

查询响应包含任务状态、交付文件和结算引用。

音色资源

GET  /api/v1/media-voices
POST /api/v1/media-voices
GET  /api/v1/media-voices/{asset_id}
POST /api/v1/media-voices/{asset_id}/confirm
POST /api/v1/media-voices/{asset_id}/reconcile
POST /api/v1/media-voices/{asset_id}/revoke

reconcile 用于不确定的远程结果恢复；它只核对原操作，不会新建第二个音色资源。

创建音色必须确认录音来源权利：

{
  "document_id": "authorized_recording_document_id",
  "consent": true,
  "consent_version": "voice-source-rights-v1"
}

调用方负责确保录音来自本人或已获得有效授权。