素材库 API

本文档描述 maasapi.casdao.com 的素材库接口，视频部分上游对接 art-api.3dhaoxuan.com（Doubao Seedance 系列模型）。

接口路径

地址：https://maasapi.casdao.com/createAsset

请求方式

POST 方式，请求参数为 JSON 格式

输入说明

请求头

请求头	说明
Authorization	Bearer token

请求体

Body（原样透传 + GroupID 转换）

Body 按上游 CreateAssetGroup 格式透传，除 GroupID（别名 → 真实 ID 映射）外不做任何修改。

字段	类型	必填	说明
Name	string	是	素材库名称，上限 64 字符
Description	string	否	描述，上限 300 字符
GroupType	string	否	素材库类型，如 AIGC
ProjectName	string	否	项目名称，默认 default
GroupID / GroupId	string	否	分组别名 casdao国外 casdao-cn国内
URL	string	否	素材地址（如需关联素材）
AssetType	string	否	素材类型，如 Image

其他字段也会被原样透传，网关不做白名单限制。

请求示例

curl -X POST "https://maasapi.casdao.com/createAsset/" \
  -H "Authorization: Bearer <你的令牌>" \
  -H "Content-Type: application/json" \
  -d '{
    "GroupId": "casdao-cn",
    "URL": "https://url.png",
    "Name": "test",
    "AssetType": "Image",
    "ProjectName": "default"
  }'

响应

上游响应原样透传（状态码 + Body）。

成功示例

{
  "ResponseMetadata": {
    "RequestId": "20260328000000000000000000000000",
    "Action": "CreateAssetGroup",
    "Version": "2024-01-01",
    "Service": "ark",
    "Region": "cn-beijing"
  },
  "Result": {
    "Id": "group-2026**********-*****"
  }
}

错误说明（网关侧）

网关层错误返回 application/json，格式为 {"error": "..."}。

HTTP 状态码	error 信息	说明
400	read request body failed	读取请求体失败
403	channel is disabled	固定渠道被停用
401	上游鉴权失败	令牌无效（TokenAuth）