# 状态与原因

任务、交付、结算、素材和账单的全部取值。

## 任务状态 status

| 取值 | 含义 | 是否终态 |
| --- | --- | --- |
| `queued` | 排队中 | 否 |
| `processing` | 处理中 | 否 |
| `succeeded` | 已成功 | 是 |
| `failed` | 已失败 | 是 |
| `cancelled` | 已取消 | 是 |

## 执行阶段 phase

| 取值 | 含义 |
| --- | --- |
| `preparing_assets` | 准备素材 |
| `waiting_route` | 等待处理 |
| `submitting` | 准备生成 |
| `provider_processing` | 生成中 |
| `reconciling` | 确认结果中 |
| `finalizing` | 整理结果 |
| `settlement_pending` | 等待结算 |

## 交付状态 delivery_status

| 取值 | 含义 |
| --- | --- |
| `pending` | 待交付 |
| `materializing` | 准备下载 |
| `available` | 可下载 |
| `output_unavailable` | 结果不可用 |

## 结算状态 settlement_status

| 取值 | 含义 |
| --- | --- |
| `reserved` | 已预留费用 |
| `pending` | 待处理 |
| `reconciliation_required` | 需要核对 |
| `settled` | 已结算 |
| `settled_with_receivable` | 已结算，仍有应收金额 |

## 任务错误码 error.code

| 取值 | 含义 |
| --- | --- |
| `no_common_asset_route` | 素材暂不可用 |
| `asset_not_ready` | 引用素材仍在处理中 |
| `asset_review_timeout` | 素材审核超时 |
| `route_misconfigured` | 服务配置错误 |
| `route_temporarily_unavailable` | 暂不可用 |
| `generation_expired` | 生成已超时 |
| `generation_failed` | 生成失败 |
| `input_fetch_failed` | 输入素材下载失败 |
| `input_url_not_allowed` | 输入素材链接不允许下载 |
| `input_too_large` | 输入素材超过大小上限 |
| `input_unsupported` | 输入素材格式、尺寸或时长不受支持 |
| `input_rejected` | 输入素材未通过内容审核 |
| `input_preparation_failed` | 未能及时准备输入素材 |
| `input_duration_exceeded` | 输入素材总时长超过型号上限 |

## 素材状态 status

| 取值 | 含义 |
| --- | --- |
| `processing` | 处理中 |
| `active` | 素材已可用 |
| `unavailable` | 不可用 |

## 素材不可用原因 failure_reason

| 取值 | 含义 |
| --- | --- |
| `source_url_not_allowed` | 来源地址不符合获取策略 |
| `source_fetch_failed` | 来源获取失败 |
| `source_too_large` | 来源文件过大 |
| `media_type_mismatch` | 媒体类型不匹配 |
| `media_constraints_violated` | 不符合媒体约束 |
| `review_rejected` | 素材审核未通过 |
| `review_unavailable` | 素材审核暂不可用 |
| `internal_error` | 服务未能完成请求 |

## 取消结果 cancel_status

| 取值 | 含义 |
| --- | --- |
| `requested` | 已请求取消 |
| `effective` | 取消已生效 |
| `not_effective` | 取消未生效 |
| `failed` | 失败 |

## 账单事件 event_type

| 取值 | 含义 |
| --- | --- |
| `hold_created` | 创建费用预留 |
| `hold_increased` | 增加费用预留 |
| `hold_reduced` | 减少费用预留 |
| `charge_captured` | 收取费用 |
| `supplemental_charge` | 补充计费 |
| `receivable_created` | 新增应收 |
| `receivable_payment` | 支付应收 |
| `receivable_reduced` | 减少应收 |
| `hold_released` | 释放费用预留 |
| `refund_posted` | 退款已记账 |
| `charge_waived` | 费用已免除 |
| `manual_adjustment` | 人工调整 |