素材库

Seedance 可复用素材托管：上传图片 / 视频 / 音频后，在视频生成请求中用 asset://<id> 引用，避免大文件反复上传。平台已对接移动云 MoMA AICC（与 chinamobile-seedance-2.0 同租户）以及测试通道素材库（与 jade-test-seedance-2.0 同租户，请求时传 provider=jade）。客户只需使用本平台 API Key，无需持有上游凭证。

鉴权

所有 /v1/* 接口均必须携带平台 API Key：Authorization: Bearer sk-pyo-...。Key 在控制台 → API Keys 创建。上游移动云等供应商 Key 由平台托管，客户无需直接使用。

提供商选择

provider	适用 model	说明
（默认 / auto）	chinamobile-seedance-2.0	优先移动云；不自动切到测试通道
jade	jade-test-seedance-2.0	body 或 ?provider=jade；素材与测试视频同租户，asset:// 可出片
volc	火山直连视频	火山素材租户

能力范围

场景	说明	客户接口
私域虚拟人像（AIGC）	自建虚拟素材组并上传图片/视频/音频，入库后用 asset:// 出片	POST /v1/assets/groups + /items
私域真人（LivenessFace）	须 H5 活体认证创建真人组，再向该组上传同人素材；不可用 CreateGroup 直接建真人组	POST /v1/assets/real-person/sessions → by-token → /items
公域虚拟人像	体验中心官方可信库，无独立 OpenAPI；本平台不代理公域浏览	—

REST 接口一览

方法	路径	说明
POST	/v1/assets/groups	创建素材组
GET	/v1/assets/groups	列出素材组
GET	/v1/assets/groups/{id}	查询素材组
PATCH	/v1/assets/groups/{id}	更新素材组
DELETE	/v1/assets/groups/{id}	删除素材组
POST	/v1/assets/items	上传素材（公网 URL）
GET	/v1/assets/items	列出素材（须 group_type）
GET	/v1/assets/items/{id}	查询素材详情
PATCH	/v1/assets/items/{id}	更新素材
DELETE	/v1/assets/items/{id}	删除素材
POST	/v1/assets/virtual-character	一键虚拟人物三视图
POST	/v1/assets/real-person/sessions	真人 H5 认证会话
POST	/v1/assets/real-person/groups/by-token	byted_token 换真人素材组
GET	/v1/assets	服务状态（无需 Action）

真人素材最短示例

生产模型 chinamobile-seedance-2.0 用默认素材库。测试模型 jade-test-seedance-2.0 必须加 provider=jade，完整步骤见测试通道指南。

# 生产通道（默认）
curl -X POST "https://www.openmodels.com.cn/v1/assets/real-person/sessions" \
  -H "Authorization: Bearer <OPENMODELS_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{}'

# 测试通道 jade-test-seedance-2.0（必传 provider=jade；不要传 callback_url）
curl -X POST "https://www.openmodels.com.cn/v1/assets/real-person/sessions" \
  -H "Authorization: Bearer <OPENMODELS_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{ "provider": "jade" }'

# 返回 byted_token + h5_url，引导用户手机完成活体认证

# 认证成功后换取真人素材组
curl -X POST "https://www.openmodels.com.cn/v1/assets/real-person/groups/by-token" \
  -H "Authorization: Bearer <OPENMODELS_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{ "byted_token": "<byted_token>", "provider": "jade" }'

# 向该 group_id 上传同人素材
# POST /v1/assets/items  { group_id, url, provider: "jade", wait_active: true }
# 列表：GET /v1/assets/items?group_type=LivenessFace&group_id=...&provider=jade

Action 兼容接口

若已对接火山方舟风格，可继续使用 POST /v1/assets?Action=<Action>&Version=2024-01-01，请求体字段与火山一致（Name / GroupId / URL / AssetType 等）。常用 Action：CreateAssetGroup、ListAssetGroups、GetAssetGroup、UpdateAssetGroup、DeleteAssetGroup、CreateAsset、ListAssets、GetAsset、UpdateAsset、DeleteAsset、CreateVisualValidateSession、GetAssetGroupByBytedToken。

POST/v1/assets?Action=CreateAssetGroup&Version=2024-01-01已上线

素材约束（摘要）

类型	要求
Image	jpeg/png/webp/bmp/tiff/gif/heic/heif；宽高比 (0.4,2.5)；边长 (300,6000)px；<30MB
Video	mp4/mov；480p/720p/1080p；时长 [2,15]s；<50MB；FPS [24,60]
Audio	wav/mp3；时长 [2,15]s；<15MB

上传仅支持公网 URL，不支持 Base64。CreateAsset 为异步：返回 id 后须轮询至 Active 再用于推理。虚拟人像走 AIGC 素材组；真人须先走 H5 认证。

最短 REST 示例

# 1) 创建素材组
curl -X POST "https://www.openmodels.com.cn/v1/assets/groups" \
  -H "Authorization: Bearer <OPENMODELS_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{ "name": "demo-group", "group_type": "AIGC" }'

# 2) 上传图片（可加 "wait_active": true 同步等到 Active）
curl -X POST "https://www.openmodels.com.cn/v1/assets/items" \
  -H "Authorization: Bearer <OPENMODELS_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "group_id": "<group_id>",
    "url": "https://example.com/ref.jpg",
    "name": "ref-1",
    "asset_type": "Image",
    "wait_active": true
  }'

# 3) 查询
curl "https://www.openmodels.com.cn/v1/assets/items/<asset_id>" \
  -H "Authorization: Bearer <OPENMODELS_API_KEY>"

# 返回字段 asset_uri 形如 asset://asset-xxxx ，用于视频生成

一键虚拟人物三视图

POST/v1/assets/virtual-character已上线

curl -X POST "https://www.openmodels.com.cn/v1/assets/virtual-character" \
  -H "Authorization: Bearer <OPENMODELS_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "virtual-character",
    "wait_active": true,
    "views": [
      { "url": "https://example.com/front.png", "label": "front" }
    ]
  }'

细分接口文档：创建素材组、列出素材组、查询素材组、更新素材组、删除素材组、上传素材、列出素材、查询素材、更新素材、删除素材、真人 H5 认证、byted_token 换组、一键虚拟人物。

素材库

鉴权