⑥ 上传素材
POST /v1/private-avatar/assets
概览
| Method | POST |
|---|---|
| Path | /v1/private-avatar/assets |
| Type | http |
| Status | 1 |
| Module | 2102810 |
| Folder | 87318196 |
参数
{ "path": [], "query": [], "cookie": [], "header": [] }
请求体
{ "type": "application/json", "parameters": [], "jsonSchema": { "type": "object", "required": [ "model", "GroupId", "URL", "AssetType" ], "properties": { "model": { "type": "string", "description": "路由选择参数(固定传此值)", "enum": [ "doubao-seedance-2-0-260128", "doubao-seedance-2-0-fast-260128" ], "examples": [ "doubao-seedance-2-0-260128" ] }, "GroupId": { "type": "string", "description": "接口①返回的 Result.Id", "examples": [ "group-20260601191715-9q47m" ] }, "URL": { "type": "string", "description": "素材公网可访问地址(字段名全大写 URL)", "examples": [ "https://example.com/figure.jpg" ] }, "AssetType": { "type": "string", "enum": [ "Image", "Video", "Audio" ], "description": "首字母大写", "examples": [ "Image" ] }, "Name": { "type": "string", "description": "素材备注名(可选)", "examples": [ "full-body" ] } }, "x-apifox-orders": [ "model", "GroupId", "URL", "AssetType", "Name" ] }, "mediaType": "application/json", "oasExtensions": "", "required": true, "additionalContentTypes": [], "examples": [ { "mediaType": "application/json", "value": "{\n \"model\": \"doubao-seedance-2-0-260128\",\n \"GroupId\": \"group-20260602153837-5vm6c\",\n \"URL\": \"https://picsum.photos/800/1200.jpg\",\n \"AssetType\": \"Image\",\n \"Name\": \"full-body\"\n}" } ] }
响应
[ { "id": 170187889, "name": "", "code": 200, "contentType": "json", "jsonSchema": { "type": "object", "properties": { "ResponseMetadata": { "type": "object", "properties": { "RequestId": { "type": "string", "examples": [ "20260601191715C9DAA092032F19CEC367" ] }, "Action": { "type": "string", "examples": [ "CreateAssetGroup" ] }, "Version": { "type": "string", "examples": [ "2024-01-01" ] }, "Service": { "type": "string", "examples": [ "ark" ] }, "Region": { "type": "string", "examples": [ "cn-beijing" ] }, "Error": { "type": "object", "properties": { "Code": { "type": "string", "examples": [ "AccessDenied" ] }, "Message": { "type": "string" } }, "x-apifox-orders": [ "Code", "Message" ] } }, "x-apifox-orders": [ "RequestId", "Action", "Version", "Service", "Region", "Error" ] }, "Result": { "type": "object", "properties": { "Id": { "type": "string", "description": "AssetId,用于接口⑧轮询和 asset://引用", "examples": [ "asset-20260318071009-xxxxx" ] } }, "x-apifox-orders": [ "Id" ] } }, "x-apifox-orders": [ "ResponseMetadata", "Result" ] }, "itemSchema": {}, "description": "提交成功(素材处于 Processing,需轮询)", "mediaType": "application/json", "headers": [], "oasExtensions": "" } ]