---
title: "确认资源上传"
method: POST
path: "/api/assets/{id}/confirm"
tags: ["资源管理"]
---

# 确认资源上传

`POST /api/assets/{id}/confirm`

接口说明：客户端直传对象存储完成后回调确认，记录资源最终状态与访问路径。

## Path parameters

- `id` string, required

## Response `200`

请求已被服务处理。业务是否成功以响应体 code === 0 为准。

- object
  - `data` AssetVo
    - `id` string, required — 唯一标识
    - `userId` string, required — 用户 ID
    - `userType` 'user' | 'admin' | 'system', required — 用户类型
    - `path` string, required — 资源存储路径
    - `url` string — 资源 URL
    - `type` 'aiImage' | 'aiVideo' | 'aiCard' | 'aiChatImage' | 'aideoOutput' | 'videoEdit' | 'dramaRecap' | 'styleTransfer' | 'imageEdit' | 'subtitle' | 'userMedia' | 'userFile' | 'publishMedia' | 'avatar' | 'agentSession' | 'videoThumbnail' | 'googlePlace' | 'brandLibrary' | 'temp', required — 类型标识
    - `status` 'pending' | 'uploaded' | 'confirmed' | 'failed', required — 业务状态
    - `size` number — 资源大小
    - `mimeType` string, required — 媒体类型
    - `filename` string — 文件名
    - `metadata` union — 扩展元数据
      - object
        - `width` number, required — 宽度
        - `height` number, required — 高度
      - object
        - `width` number — 宽度
        - `height` number — 高度
        - `duration` number — 时长
        - `cover` string — 封面
        - `bitrate` number — 比特率
        - `frameRate` number — 帧率
      - object
        - `duration` number, required — 时长
        - `bitrate` number — 比特率
        - `sampleRate` number — 采样率
        - `channels` number — 声道数
    - `createdAt` string, date-time, required — 创建时间
    - `updatedAt` string, date-time, required — 更新时间
  - `code` integer, required — 业务状态码。0 表示成功，非 0 表示业务错误。
  - `message` string, required — 响应消息。
  - `requestId` string — 请求 ID。
  - `timestamp` integer — 错误响应时间戳，Unix 毫秒。

---

[API](https://skmtc.net/aitoearn/apis/aitoearn-api.md) · [All operations](https://skmtc.net/aitoearn/apis/aitoearn-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aitoearn/aitoearn-api/versions/19d860d9260d/schema)