---
title: "Reserve an authenticated upload / 预留上传"
method: POST
path: "/uploads"
---

# Reserve an authenticated upload / 预留上传

`POST /uploads`

## Request

- Base URL: `https://clipmivoai.com/api/open/v1`
- URL: `https://clipmivoai.com/api/open/v1/uploads`
- Auth: HTTP bearer

## Request body

- UploadRequest: Duration is required for audio/video and declared by the client. Character assets require explicit consent. / 音视频需客户端声明时长，角色素材需明确同意。
  - `name` string, required
  - `mime` string, required
  - `size` integer, required
  - `duration` number
  - `character` boolean
  - `consent` boolean

## Response `201`

Success / 成功

- object
  - `success` unknown, required
  - `request_id` string, required
  - `data` UploadReservation, required
    - `id` string, required
    - `path` string, required
    - `token` string, required
    - `expires` integer, required
    - `method` 'PUT', required

## Other responses

- `400`: Request rejected / 请求被拒绝
- `401`: Request rejected / 请求被拒绝
- `403`: Request rejected / 请求被拒绝
- `404`: Request rejected / 请求被拒绝
- `409`: Request rejected / 请求被拒绝
- `413`: Request rejected / 请求被拒绝
- `422`: Request rejected / 请求被拒绝
- `429`: Request rejected / 请求被拒绝
- `503`: Request rejected / 请求被拒绝

---

[API](https://skmtc.dev/clipmivoai/apis/clipmivoai-api.md) · [All operations](https://skmtc.dev/clipmivoai/apis/clipmivoai-api/llms.txt) · [OpenAPI document](https://skmtc.dev/clipmivoai/apis/clipmivoai-api/revisions/6e6d5f5a84a7?raw)