常见问题

视频生成（Seedance）

三个，都在 seedance 分组下：

调用时模型名必须原样填写，不要自行简写。

模型	480p	720p	1080p	2K	4K
`dreamina-seedance-2-0-260128`	✅	✅	✅	❌	❌
`dreamina-seedance-2-0-fast-260128`	✅	✅	❌	❌	❌
`dreamina-seedance-2-0-mini-260615`	✅	✅	❌	❌	❌

实际出片尺寸：480p → 864×496，720p → 1280×720，1080p → 1920×1080。

请求不支持的分辨率会返回 400，错误原样透传：

{
  "code": "invalid_resolution",
  "message": "resolution 1080p is not supported by dreamina-seedance-2-0-fast-260128"
}

按上游返回的 total_tokens 计费，token 数随像素数与时长增长。以 5 秒片为例：480p 约 5.06 万 token、720p 约 10.89 万、1080p 约 24.50 万，比值与像素比一致（1 : 2.15 : 4.84）。

单价（美元 / 百万 token）：

模型	480p / 720p	1080p	含参考视频（480p / 720p）	含参考视频（1080p）
`dreamina-seedance-2-0-260128`	$7.0	$7.7	$4.3	$4.73
`dreamina-seedance-2-0-fast-260128`	$5.6	—	$3.3	—
`dreamina-seedance-2-0-mini-260615`	$3.5	—	$2.1	—

两条规则：

举例：mini 跑一条 480p / 5 秒，约 50,638 token × $3.5/M ≈ $0.177。

采用预扣 + 结算退差：下单先按上限预扣，任务完成后按实际 token 结算并退回差额。

以 mini 480p / 5 秒为例：预扣 437,500 → 退回 348,884 → 实际净扣 88,616（额度单位）。1080p 的预扣也会按 1.1 倍档位相应抬高。

任务失败或被拒时预扣全额退回。

这是上游行为，网关如实透传：

409 InvalidAction.RunningTaskDeletion —— 任务已进入 running 状态，上游不允许删除。任务提交后通常 2 秒内就会进入该状态。
404 —— 个别上游线路没有实现取消接口。

结论：任务一旦被接受，基本会跑完并计费，不要依赖取消来止损，参数请在提交前确认。

出片走对象存储预签名直链，有效期 24 小时。过期后通过 /v1/videos/{id}/content 代理也取不回来，请在有效期内自行转存。

创建素材组 → 上传素材 → 轮询至 Active → 生成时用 asset:// 引用

素材上传后由上游异步下载入库，通常 20 秒内变为 Active；未到 Active 就拿去生成会失败。详见素材库文档。

三种写法，放在请求体里任何字符串字段中都会被识别：

素材是上游账号级资源。网关会把每个素材、每个素材组绑定到创建它的渠道与具体密钥上，后续查询、修改、删除以及引用它的生成请求都会被强制路由回同一处。

换一个分组的密钥去访问，上游那边根本没有这条记录，只会报「素材不存在」。所以：同一批素材请始终用同一个 API 密钥操作。

不能。如果一个生成请求同时引用了分属不同渠道的素材，网关会直接返回 400 并说明冲突，不会挑一个渠道碰运气——因为无论选哪个，都必然有一半素材不可用。

不受保护。网关只为经本网关创建的素材维护归属索引；索引里没有的引用会走通用路由，可能落到任何一条线路，结果不可预期。建议素材统一通过本平台的素材库接口创建。

CreateVisualValidateSession → 用户在 H5 页完成活体认证 → GetVisualValidateResult

认证通过后会返回一个真人素材组 ID，它此后就是一个普通素材组，可以用 asset://{组ID} 在生成请求里整组引用。轮询认证结果必须用创建会话时的同一个密钥。

接口细节见真人认证。

平台侧不设条数上限，实际以上游账号的配额为准。