星海智算开发文档

上传输入素材

接口参考来自当前平台公开协议。具体模型的模式和规格请在模型详情中确认。

POST/v1/assets/input

身份认证

bearerAuth
认证方式Bearer <token>

传入位置: header

查询参数

model*string

限定任务或素材所属模型范围的公开别名；须在当前 API Key 授权范围内。

请求头参数

X-Client-Request-Id?string

可选客户端关联值，只能包含可见 ASCII，最多 512 字节；不能替代服务端 requestId。

长度length <= 512

请求正文

multipart/form-data

每次上传一个文件，遵守 GET /v1/services 的 mediaSpecContract。通用上限：PNG/JPEG/WebP 图片 16 MiB，WAV 音频 25 MiB，MP4 视频 128 MiB。H3 全能参考：图片 30 MiB，MP4 视频 50 MiB，音频 15 MiB；支持 WAV/MP3/FLAC/M4A/AAC/OGG 或带音轨 MOV。MOV 须用 audio 字段上传，保留音频身份和原字节，不作为视频参考。H3 音频每段 2～15 秒、最多 3 段、合计不超过 15 秒；首尾帧图片仍使用各自 16 MiB 限制。

每次上传一个文件，遵守 GET /v1/services 的 mediaSpecContract。通用上限：PNG/JPEG/WebP 图片 16 MiB，WAV 音频 25 MiB，MP4 视频 128 MiB。H3 全能参考：图片 30 MiB，MP4 视频 50 MiB，音频 15 MiB；支持 WAV/MP3/FLAC/M4A/AAC/OGG 或带音轨 MOV。MOV 须用 audio 字段上传，保留音频身份和原字节，不作为视频参考。H3 音频每段 2～15 秒、最多 3 段、合计不超过 15 秒；首尾帧图片仍使用各自 16 MiB 限制。

响应正文

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

{  "asset": {    "assetId": "string",    "byteSize": 0,    "createdAt": "2019-08-24T14:15:22Z",    "expiresAt": "2019-08-24T14:15:22Z",    "ingestedAt": "2019-08-24T14:15:22Z",    "kind": "image",    "lastUploadedAt": "2019-08-24T14:15:22Z",    "mimeType": "string",    "publicationId": "string",    "reused": true,    "status": "available",    "storageBackend": "string",    "storageMode": "personal_30d"  },  "usage": {}}