完成视频上传
从真实 complete_video_upload 工具生成输入、输出、OAuth 权限与安全注解,与经过核实的 MCP 契约保持一致。
本页目录
工具
complete_video_upload
校验视频并返回 file_id 及实测时长、尺寸,不启动生成。
权限与安全
OAuth 权限:files:write
| 信号 | 值 |
|---|---|
destructiveHint |
false |
idempotentHint |
true |
openWorldHint |
false |
readOnlyHint |
false |
| spendsCredits | false |
| requiresUserConfirmation | false |
| sideEffects | uploaded_video_persisted |
注解用于描述安全属性,不能替代用户批准、OAuth 授权或服务端校验。
输入参数
| 字段 | 类型 | 必填 | 默认值 | 约束 | 含义 |
|---|---|---|---|---|---|
upload_id |
string |
是 | — | format: uuid |
— |
参数示例
{
"upload_id": "00000000-0000-4000-8000-000000000008"
}
结构化返回
| 字段 | 类型 | 必填 | 默认值 | 约束 | 含义 |
|---|---|---|---|---|---|
byte_size |
integer |
是 | — | — | 校验后的来源字节数。 |
duration_seconds |
number |
是 | — | — | 实测来源时长,选区必须在其范围内。 |
file_id |
string |
是 | — | format: uuid |
用于 input.reference_video.source、type=file 的已完成视频文件 ID。 |
height |
integer |
是 | — | — | 来源显示高度,像素。 |
mime_type |
string |
是 | — | — | 校验后的视频类型。 |
object |
string |
否 | "file" |
const: "file" |
— |
sha256 |
string |
是 | — | — | 存储来源字节的 SHA-256。 |
width |
integer |
是 | — | — | 来源显示宽度,像素。 |
错误与后续步骤
工具错误包含 error 对象,内有 code、message、retryable、request_id 和 details。不要依赖消息文本分支或泄露私有输入。终态失败也要检查部分产物;返回签名 URL 不代表已保存文件。
这篇文档有帮助吗?
不收集搜索词、代码或自由文本。此开关只控制文档交互事件;站点通用分析仍遵循隐私政策。 隐私政策