准备图片上传
从真实 prepare_image_upload 工具生成输入、输出、OAuth 权限与安全注解，与经过核实的 MCP 契约保持一致。
本页目录
工具
prepare_image_upload
创建短期上传会话；客户端按返回的方法和请求头上传准确字节，再完成上传。本地路径不能替代文件传输。
权限与安全
OAuth 权限：files:write
| 信号 | 值 |
|---|---|
destructiveHint |
false |
idempotentHint |
false |
openWorldHint |
true |
readOnlyHint |
false |
| spendsCredits | false |
| requiresUserConfirmation | false |
| sideEffects | temporary_upload_created |
注解用于描述安全属性，不能替代用户批准、OAuth 授权或服务端校验。
输入参数
| 字段 | 类型 | 必填 | 默认值 | 约束 | 含义 |
|---|---|---|---|---|---|
byte_size |
integer |
是 | — | exclusiveMinimum: 0 |
客户端将通过 PUT 发送的准确字节数。 |
filename |
string |
是 | — | minLength: 1; maxLength: 240 |
客户端文件名，不是服务端可以读取的本地路径。 |
mime_type |
string |
是 | — | pattern: ^image/(png|jpeg|webp)$ |
图片实际 MIME 类型。 |
参数示例
{
"byte_size": 1024,
"filename": "character.png",
"mime_type": "image/png"
}
结构化返回
| 字段 | 类型 | 必填 | 默认值 | 约束 | 含义 |
|---|---|---|---|---|---|
expires_at |
string |
是 | — | format: date-time |
上传 URL 过期时间。 |
headers |
object |
是 | — | — | 实际传输请求头，不额外添加 MCP Token 或 API Bearer 凭据。 |
max_bytes |
integer |
是 | — | — | 允许上传的最大字节数。 |
method |
string |
否 | "PUT" |
const: "PUT" |
客户端传输字节时必须使用的 HTTP 方法。 |
upload_id |
string |
是 | — | format: uuid |
传给 complete_image_upload 的上传会话 ID，不是最终 file_id。 |
upload_url |
string |
是 | — | — | 敏感短期上传 URL，需传输实际字节，不公开此地址。 |
错误与后续步骤
工具错误包含 error 对象，内有 code、message、retryable、request_id 和 details。不要依赖消息文本分支或泄露私有输入。终态失败也要检查部分产物；返回签名 URL 不代表已保存文件。
这篇文档有帮助吗？
不收集搜索词、代码或自由文本。此开关只控制文档交互事件；站点通用分析仍遵循隐私政策。 隐私政策