API v1

视频任务对象

视频任务详情。

查看 Markdown
  • 结果不可用时任务保持处理中、结算需核对;成功任务有结果素材,且交付已可用。
  • 失败或取消的任务结算可为待处理或已结算;已结算的失败或取消任务最终费用及未收款为零。

属性

#idstring必填

平台任务标识。

长度4–128字符A–Z a–z 0–9 _ -
#objectstring必填

对象类型标识。

固定为video.task
#request_idstring必填

请求关联标识。

长度4–128字符A–Z a–z 0–9 _ -
#billing_correlation_idstring必填

费用关联标识。

长度4–128字符A–Z a–z 0–9 _ -
#modelstring必填

本次使用的模型标识。

dreamina-seedance-2-0-260128Seedance 2.0
dreamina-seedance-2-0-fast-260128Seedance 2.0 Fast
dreamina-seedance-2-0-mini-260615Seedance 2.0 Mini
#statusstring必填

当前状态,具体含义见对应取值。

queued排队中
processing处理中
succeeded已成功
failed已失败
cancelled已取消
#phasestring必填可能为空

任务执行阶段;没有当前阶段时为空。

preparing_assets准备素材
waiting_route等待处理
submitting准备生成
provider_processing生成中
reconciling确认结果中
finalizing整理结果
settlement_pending等待结算
null空值
#delivery_statusstring必填

结果交付状态。

pending待交付
materializing准备下载
available可下载
output_unavailable结果不可用
#settlement_statusstring必填

当前费用结算状态。

reserved已预留费用
pending待处理
reconciliation_required需要核对
settled已结算
settled_with_receivable已结算,仍有应收金额
#created_atinteger必填

创建时间,Unix 整数秒。

范围≥ 0
#started_atinteger必填可能为空

任务开始时间,未开始时为空。

范围≥ 0
#completed_atinteger必填可能为空

任务完成时间,未完成时为空。

范围≥ 0
#usageobject必填可能为空

任务用量对象,可为空。

7 个子字段
#meter_typestring必填

用量计量类型。

固定为seedance_video_generation
#video_tokensinteger必填可能为空

视频计量单位数;实际用量允许为空的情况以字段类型为准。

范围≥ 0
#output_duration_secondsinteger必填

输出视频时长,秒。

范围≥ 0
#input_video_duration_secondsinteger必填

输入参考视频总时长,秒。

范围≥ 0
#resolutionstring必填

输出分辨率。fast 和 mini 仅支持 480p 或 720p。

可选480p720p1080p
#fpsinteger必填

视频帧率。

范围1–120
#has_reference_videoboolean必填

是否使用参考视频。

#billingobject必填

任务结算摘要,可为空。

8 个子字段
#currencystring必填

金额币种,美元。

固定为USD
#final_actual_coststring必填可能为空

最终实际费用;尚未确定时为空。

格式6 位小数
#collected_liability_amountstring必填

已收取的计费金额。

格式6 位小数
#funding_debit_amountstring必填

实际扣减的资金金额。

格式6 位小数
#refunded_liability_amountstring必填

已退回的计费金额。

格式6 位小数
#funding_refund_amountstring必填

实际退回的资金金额。

格式6 位小数
#outstanding_receivablestring必填

尚未收取的应收金额。

格式6 位小数
#billing_urlstring必填

本任务的费用明细相对路径。

格式/v1/video/tasks/{task_id}/billing
#outputobject必填可能为空

任务生成结果,可为空。

1 个子字段
#assetsarray必填

结果素材列表。

数量1–16
9 个子字段
#asset_idstring必填

平台素材标识。

长度4–128字符A–Z a–z 0–9 _ -
#media_typestring必填

媒体类型。

可选videoimageaudio
#rolestring必填

素材在输入或结果中的用途。

result生成结果
last_frame尾帧
audio音频
#urlstring必填可能为空

可下载时为 HTTPS 下载地址;过期或不可用时为空。

长度12–4096格式https://
#materialized_atinteger必填可能为空

结果准备完成的时间,Unix 整数秒。

范围≥ 0
#expires_atinteger必填可能为空

结果到期时间,为结果准备完成后再过当时生效的保留期(默认 7 天),与任务完成时间分别计算。

范围≥ 0
#delivery_sourcestring必填

结果交付来源。

platform平台交付
#materialization_statusstring必填

结果准备状态。

completed已完成
retrying重试中
failed失败
#download_statusstring必填

下载状态:可用、过期或不可用。

available可用
expired已过期
unavailable不可用
#cancellationobject必填可能为空

取消状态投影,可为空。

3 个子字段
#cancel_operation_idstring必填

取消操作的稳定标识。

长度4–128字符A–Z a–z 0–9 _ -
#statusstring必填

当前状态,具体含义见对应取值。

requested已请求取消
effective取消已生效
not_effective取消未生效
failed失败
#reason_codestring必填可能为空

取消未生效或失败时的原因码;已请求或已生效时为空。

长度1–96字符a–z 0–9 _
#errorobject必填可能为空

错误对象。

3 个子字段
#codestring必填

机器可读错误码。

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输入素材总时长超过型号上限
#messagestring必填

供人阅读的错误说明。

长度1–1024
#detailsobject

可选的结构化错误详情。

1 个子字段
#content_indexinteger

失败输入在原始 content 数组中的下标,从 0 起,文字项也计入。

范围0–50

用「查询视频任务」读取这个对象。