跳转到正文
使用文档

搜索文档

搜索只在此浏览器中进行,关键词不发送、不保存。请勿粘贴凭据。

正在加载公开搜索索引…

Tab 或方向键选择 · Enter 打开 · Esc 关闭
浏览文档目录

准备视频上传

从真实 prepare_video_upload 工具生成输入、输出、OAuth 权限与安全注解,与经过核实的 MCP 契约保持一致。

公开测试最后核实
本页目录

工具

prepare_video_upload

创建私有视频上传会话,限制 100 MiB、30 秒;传输后完成校验,不启动深度处理。

权限与安全

OAuth 权限:files:write

信号 值
destructiveHint false
idempotentHint false
openWorldHint true
readOnlyHint false
spendsCredits false
requiresUserConfirmation false
sideEffects temporary_upload_created

注解用于描述安全属性,不能替代用户批准、OAuth 授权或服务端校验。

输入参数

字段 类型 必填 默认值 约束 含义
request VideoUploadRequest 是 — — —

参数示例

json
{
  "request": {
    "byte_size": 1024,
    "filename": "motion.mp4",
    "mime_type": "video/mp4"
  }
}

结构化返回

字段 类型 必填 默认值 约束 含义
expires_at string 是 — format: date-time 上传会话到期的 UTC 时间。
headers object 是 — — 传输字节使用这些请求头。
max_bytes integer 是 — — 来源字节数上限。
method string 否 "PUT" const: "PUT" —
upload_id string 是 — format: uuid 传输字节后需完成的会话,目前还不能作为视频输入。
upload_url string 是 — — 敏感短期上传 URL;传输字节时不附加 API/OAuth 凭据。

VideoUploadSession

错误与后续步骤

工具错误包含 error 对象,内有 code、message、retryable、request_id 和 details。不要依赖消息文本分支或泄露私有输入。终态失败也要检查部分产物;返回签名 URL 不代表已保存文件。

标准工作流 · 支出保护

这篇文档有帮助吗?

不收集搜索词、代码或自由文本。此开关只控制文档交互事件;站点通用分析仍遵循隐私政策。 隐私政策

需要帮助?联系支持