常见问答

本页面面向企业客户的技术评估、合规审查和故障排查。建议在生产环境保留请求标识、任务标识、调用时间和响应摘要，形成可审计的调用记录。

Q：如何核验 Seedance 2.0 使用的是官方链路？

A： 平台的公开调用链路由真人认证、素材库、视频生成和任务回调组成。企业客户可以通过每个环节的官方资源标识进行交叉核验，而不只依赖页面说明或结果 URL。

企业应用
  → 平台 API
  → 火山真人认证
  → 火山官方素材库
  → Seedance 2.0 视频生成
  → 上游任务状态/回调
  → 火山视频资源

真人认证链路

真人素材认证调用火山 ARK 的 CreateVisualValidateSession 和 GetVisualValidateResult。可留存以下信息：

• 接口响应中的 ResponseMetadata.RequestId。
• BytedToken 对应的认证会话记录。该凭证属于敏感数据，不应写入公开日志。
• 认证成功后返回的 LivenessFace 素材组 ID。

素材库链路

素材通过火山素材 Action API 创建并进入异步处理。可通过以下信息核验：

• 素材组 GroupId 和素材 Id。
• Processing、Active、Failed 状态变化。
• 火山接口的 ResponseMetadata.RequestId。
• GetAsset 返回的临时素材 URL 及其资源域名信息。

素材 URL 有效期可能有限，企业审计应保存资源 ID、请求 ID 和状态记录，而不是只保存 URL。

视频生成链路

视频任务由 Seedance 2.0 上游接口异步执行。平台返回公开 task_id，任务完成后返回上游视频资源 URL。建议留存：

• 平台请求 ID。
• 公开 task_id。
• 请求使用的 model、resolution、ratio 和调用时间。
• 查询响应中的 actual_model、status、result_url 和 usage。
• 在有权限的日志或技术支持记录中关联上游 request ID 或 cgt task ID。

Q：平台是否会对结果再次超分或锐化？

A：不会。 平台直接调用火山引擎官方 Seedance 2.0 接口，将请求中的 resolution 原样提交至火山官方服务，并返回或代理火山官方生成结果。

• 平台不会使用低分辨率结果再次调用独立超分模型。
• 平台不会额外执行插帧、锐化、像素补全或画质增强。
• 平台不会重新编码并替换为其他生成结果。
• 返回的视频资源来自火山官方生成链路，可结合任务 ID、请求 ID 和资源 URL 进行核验。

企业验收时可以对照请求分辨率、查询响应中的 metadata.resolution、下载文件尺寸、火山任务标识和调用日志进行确认。

Q：请求唯一标识和字节任务 ID 能否返回？

A： 可以使用多层标识定位一次调用：

公开 API 默认使用平台任务 ID 隔离内部实现，不保证在所有响应中直接暴露上游 cgt task ID。需要进行故障界定或审核申诉时，可通过平台日志和技术支持建立映射。

Q：为什么正常提示词会被判定为敏感？

A： 这表示请求在内容安全检查阶段被拦截。常见错误示例：

The request failed because the input text 'content[0]' may contain sensitive information.

该错误不代表接口不支持对应业务场景。B 端 API 通常执行统一的内容安全规则；在高频调用、上下文不足或语义接近风控边界时，正常业务内容也可能出现误判。

Q：遇到疑似风控误判应该怎么处理？

A： 先停止重复提交并保存完整排障材料，再进行字段级排查；无法自行定位时，通过受控渠道提交上游核查。

1. 停止重复高频提交

不要使用完全相同的内容连续重试。重复高频请求可能增加限流和风控噪声，不利于定位原始问题。

2. 保存完整排障材料

提交技术支持前准备：

• 平台 request ID。
• 公开 task_id；如已取得，同时提供上游 request ID 或 cgt task ID。
• 精确调用时间、时区、模型和接口路径。
• 原始提示词和素材类型。提示词及素材可能包含商业敏感信息，应通过受控渠道提交。
• 预期业务用途。
• HTTP 状态、错误码和完整错误消息。

3. 先做字段级排查

• 确认提示词实际位于顶层 prompt，没有误放在不支持的字段。
• 检查 metadata.content 的 URL、类型和 role 是否符合契约。
• 将长提示词拆分，移除与业务目标无关的敏感语义，再进行最小请求验证。
• 确认没有把用户隐私、身份证件、联系方式或未经授权的人脸信息写入提示词。

4. 提交上游核查

平台可根据上述标识向火山侧提交误判案例。处理时间取决于案例复杂度和上游响应；部分已明确的个案可能较快获得反馈，但不承诺固定的解除时间。

经确认的误判案例可以作为后续风控策略优化样本，但不代表相似请求将自动永久放行。

Q：企业生产环境应该保存哪些审计字段？

A： 建议至少保存以下字段，并根据企业安全策略设置脱敏与留存周期：