---
title: "生成上传签名"
method: POST
path: "/api/assets/uploadSign"
tags: ["资源管理"]
---

# 生成上传签名

`POST /api/assets/uploadSign`

接口说明：生成用于直传对象存储的签名 URL，上传路径按用户与资源类型自动生成。查看 [资源上传教程](/zh/use/asset-upload)。

## Request body

- object
  - `filename` string, required — 文件名（带扩展名）
  - `type` 'aiImage' | 'aiVideo' | 'aiCard' | 'aiChatImage' | 'aideoOutput' | 'videoEdit' | 'dramaRecap' | 'styleTransfer' | 'imageEdit' | 'subtitle' | 'userMedia' | 'userFile' | 'publishMedia' | 'avatar' | 'agentSession' | 'videoThumbnail' | 'googlePlace' | 'brandLibrary' | 'temp' — 资源类型
  - `size` number — 文件大小（字节）

## Response `200`

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

- object
  - `data` UploadResultVo
    - `id` string, required — ID 编号
    - `path` string, required — 资源路径
    - `url` string, required — 资源 URL
    - `uploadUrl` string — 上传 URL
    - `uploadFields` object — 上传表单
  - `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)