seedance-2.0、seedance-2.0-fast 和 seedance-2.0-mini 等模型 ID，并通过 operation 选择工作流。
模型选择
seedance-2.0-fast 和 seedance-2.0-mini 不支持 1080p 和 4k 请求。音频仅可在支持的参考工作流中使用；不支持纯音频或仅文本加音频的 Seedance 请求。
支持的操作
素材概念
Seedance 素材是可复用的、组织范围内的引用，可在后续视频生成过程中进行选择。
请区分
group_id 和素材资产 id。group_id 用于组织上传；素材资产 id 用于视频生成。如果视频请求返回 Seedance material asset not found or not accessible，请确认您传入的是素材资产 id 而非 group_id，并确保该资产属于同一组织、未被删除且状态为 status: "ACTIVE"。
自动图片素材
当所选 Seedance 模型可使用 TokenLab 素材库时，您可以直接在image、image_url、image_urls、reference_images、start_image 或 end_image 中传入图片 URL 或受支持的内联 data URL。TokenLab 会把这些图片导入组织默认的虚拟人像素材组，并保留其首帧、尾帧或参考图角色。
如果素材在 60 秒内变为 ACTIVE，同一个请求会继续进入生成。如果尚未准备完成，API 会返回 409 seedance_material_preparing 和 auto_material_asset_ids；请查询这些素材直到它们变为 ACTIVE，再使用 material_asset_id 或 material_asset_ids 重试。如果所选模型暂不可使用素材库，普通图片 URL 或 data URL 会继续走常规图片路径；显式素材 ID 会返回素材可用性错误。已有虚拟人像素材 ID 和真人素材 ID 会原样使用，不会重复导入。
真人素材验证
当您的产品在使用真人作为可复用的 Seedance 引用前需要获得同意并进行人脸验证时，请使用真人素材验证。- 调用 创建视觉验证会话，传入
CallbackURL，并保存返回的Result.BytedToken。 - 为待验证人员打开
Result.H5Link。如需指定语言，请在 H5 链接后追加lng。 - H5 流程完成后，浏览器会打开
Result.CallbackURL，并携带bytedToken、resultCode等官方查询参数。 - 使用
BytedToken轮询 获取视觉验证结果，直到返回Result.GroupId。 - 保存
GroupId；创建liveness_face素材时将其作为group_id。
BytedToken 的有效期为 30 分钟。两次 Action 请求必须使用相同的 ProjectName。认证使用 Authorization: Bearer <TOKENLAB_API_KEY>，不接受火山引擎 AK/SK 签名。
可选：使用 测试控制台 来验证您的请求和回调流程、检查素材组并查看验证历史。您的生产环境集成应直接调用 API。
创建素材组
使用 创建素材资产组 创建aigc_avatar 组。新的真人组通过验证流程创建，以便将已验证的个人与素材组关联。
使用 列出素材资产组、获取素材资源组、更新素材资产组 和 删除素材资源组 在组创建后进行管理。
删除素材组也会删除其中包含的 TokenLab 素材，且该操作不可撤销。如果 TokenLab 素材库因当前授权状态不允许而无法完成删除，TokenLab 将返回一个中性的素材库错误。
上传素材
使用 创建素材资产 每次导入一个可公开访问的源 URL。 对于aigc_avatar，group_id 是可选的；TokenLab 将使用或创建组织默认的虚拟人像组。对于 liveness_face，group_id 是必需的，且必须是 获取视觉验证结果 返回的组 ID。
TokenLab 会校验源 URL、声明或探测到的媒体格式以及文件大小上限。宽高、宽高比、时长、分辨率、总像素和 FPS 采用 best effort 透传，最终由所选视频服务判断素材是否合格。
素材摄取是异步的。请轮询 获取素材资源 直到
status 变为 ACTIVE。成功的 HTTP 响应仅表示请求已被接受；请务必读取业务状态。如果状态为 FAILED，请检查 error_message，修复源素材并创建新资产。
在创建素材请求中，asset_url 只表示导入来源。TokenLab 会返回素材资产 id；生成视频时请使用这个 id，不要继续使用原始 URL。
素材与素材组 ID 使用火山兼容外观，例如 asset-20260720123456-qn7wr 和 group-20260720123456-vrt01，但它们仍是 TokenLab 自有映射 ID。
TokenLab 会将素材保留在您的组织素材库中，直到您删除该素材或其所在素材组。
对于真人素材组，一个组对应一个真人。上传内容会与已验证的人脸进行比对。包含多个人脸或人脸与已验证个人不匹配的资产可能会失败。为获得最佳效果，请同时上传一张全身正面参考图和一张人脸清晰的正面特写图。
在视频生成中使用素材
资产变为ACTIVE 后，在调用 创建视频 时，将返回的 TokenLab 资产 id 作为 material_asset_id 传入，或将其包含在 material_asset_ids 中。素材资产计入 Seedance 参考限制。
API 示例
创建一个虚拟人像组，上传一张图像，轮询直到其处于激活状态，然后在视频请求中使用该素材资产 ID。定价与异步结果
Seedance 2.0 的定价取决于输出分辨率、输入类型和模型。在硬编码产品 UI 之前，请使用 Pricing API 或 Models API。 视频生成是异步的。请遵循创建请求返回的poll_url，或使用返回的任务 ID 调用 获取任务状态。
火山风格 Seedance 兼容入口
如果你的系统已经按火山风格组织 Seedance 请求，例如使用content[]、REST 任务路径或 Action 名称，可以使用兼容入口，只替换域名和鉴权方式，不必先把请求体改成 /v1/videos/generations 的统一格式。新的跨模型视频接入仍建议优先使用 TokenLab 统一的 /v1/videos/generations。
接入流程
- 使用
Authorization: Bearer <TOKENLAB_API_KEY>鉴权。当前版本不接受火山 AK/SK 签名。 - REST 创建使用
POST /api/v3/contents/generations/tasks；Action 创建使用POST /api/v3?Action=CreateContentsGenerationsTasks&Version=2024-01-01。 - 创建响应返回
cgt-...任务 ID。用查询任务接口轮询，直到status变为succeeded、failed、cancelled或expired。 callback_url当前会被明确拒绝，请不要把它当作可用回调；本入口使用轮询拿结果。
请求体要点
content[]支持text、image_url、video_url、audio_url和draft_task。image_url不传role或传first_frame时表示首帧；last_frame必须和首帧一起使用；reference_image表示参考图。- 图片 URL 在需要素材引用的 Seedance 模型里会自动准备为 TokenLab 可复用素材。若 60 秒内仍未准备完成，创建请求会返回可重试的素材准备中错误。
- 常用生成字段包括
model、ratio、duration、resolution、generate_audio、watermark、return_last_frame、seed、priority、execution_expires_after和safety_identifier。