> ## Documentation Index
> Fetch the complete documentation index at: https://docs.zapbip.com/llms.txt
> Use this file to discover all available pages before exploring further.

# create_upload

> 为你在本地持有的字节预留一次上传。

为你在本地持有的字节预留一次上传。

## 输入

| 字段 | 类型 | 说明 |
| - | - | - |
| `filename` | string | |
| `mime_type` | string | |
| `size_bytes` | number | |

## 输出

`{ "upload_id": string, "upload_url": string, "expires_at": string }`。`upload_url` 是一个不带连接密钥的签名链接。用 `PUT` 把字节上传到它，`Content-Length` 不得大于 `size_bytes`，然后把 `upload_id` 传给 [send\_media](https://docs.zapbip.com/zh/mcp-reference/send-media.md)。上传会在 15 分钟后过期。缺少长度、请求体过大、类型错误或上传已过期，会分别以 411、413、415 或 410 被拒绝，并且不存储任何内容。

## 消息类型

| 类型 | 智能体发给所有者 | 所有者发给智能体 |
| - | - | - |
| `text` | [send\_message](https://docs.zapbip.com/zh/mcp-reference/send-message.md) | 文本 |
| `image` | [send\_media](https://docs.zapbip.com/zh/mcp-reference/send-media.md)，最大 5 MB | 1 MB 以内直接内联图片，否则为签名链接 |
| `video` | [send\_media](https://docs.zapbip.com/zh/mcp-reference/send-media.md)，最大 16 MB | 签名链接 |
| `audio` | [send\_media](https://docs.zapbip.com/zh/mcp-reference/send-media.md)，最大 16 MB，语音消息用 `voice` | 签名链接 |
| `document` | [send\_media](https://docs.zapbip.com/zh/mcp-reference/send-media.md)，最大 100 MB | 签名链接、文件名和 MIME 类型 |
| `sticker` | [send\_media](https://docs.zapbip.com/zh/mcp-reference/send-media.md) | 签名链接 |
| `location` | [send\_location](https://docs.zapbip.com/zh/mcp-reference/send-location.md) | 纬度、经度、名称和地址 |
| `contacts` | [send\_contact](https://docs.zapbip.com/zh/mcp-reference/send-contact.md) | 联系人名片 |
| `reaction` | [react](https://docs.zapbip.com/zh/mcp-reference/react.md) | `message_id` 和 `emoji`，路由给发送被回应消息的智能体 |
| `choice` | [ask](https://docs.zapbip.com/zh/mcp-reference/ask.md)，最多 3 个选项为按钮，4 到 10 个为列表 | `option_id`、`title` 和可选的 `description` |
| 引用 | 每次发送都可带 `reply_to` | `reply_to`，路由给发送被引用消息的智能体 |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.