上传素材

向指定素材组按公网 URL 入库图片 / 视频 / 音频。接口异步:返回 id 后请轮询查询接口,或设置 wait_active: true 由平台代为等待。

POST/v1/assets/items已上线

鉴权

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

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-xxxxxxxx",
    "url": "https://example.com/ref.jpg",
    "name": "ref-1",
    "asset_type": "Image",
    "wait_active": true
  }'
字段说明
group_id*素材组 ID
url*公网可访问 HTTP/HTTPS 地址(上游会拉取)
name素材名称,最长 64 字符
asset_typeImage / Video / Audio,默认 Image
wait_activetrue 时同步轮询至 Active(或超时返回 202)
provider可选。jade-test-seedance-2.0 必须传 jade;默认生产素材库
{
  "object": "asset",
  "id": "asset-xxxxxxxx",
  "group_id": "group-xxxxxxxx",
  "name": "ref-1",
  "asset_type": "Image",
  "status": "Active",
  "asset_uri": "asset://asset-xxxxxxxx"
}

Action 等价: POST /v1/assets?Action=CreateAsset&Version=2024-01-01,body:GroupId / URL / Name / AssetType。