查询回放视频播放地址
更新时间:2026-11-04
接口描述
获取一条 episode 回放视频的临时播放地址。只有创建时 recordVideo 为 true 的评测集会产出视频,videoId 取自 DescribeEmbodiedEvalResult 返回的 benchmarks[].details.tasks[].videos[].video_id。
权限说明
需要对该任务的查看权限。
请求结构
Plain Text
1GET /?action=DescribeEmbodiedEvalVideo&evalId={evalId}&videoId={videoId}
2Host: aihc.bj.baidubce.com
3Authorization: {authorization}
4version: v2
请求头域
除公共头域外,无其它特殊头域。
请求参数
| 参数名称 | 类型 | 是否必须 | 参数位置 | 说明 |
|---|---|---|---|---|
evalId |
String | 是 | Query参数 | 评测任务 ID |
videoId |
String | 是 | Query参数 | 视频 ID,以 v- 开头 |
响应头域
除公共头域外,无其它特殊头域。
响应参数
| 参数名称 | 类型 | 说明 |
|---|---|---|
requestId |
String | 请求 ID |
videoId |
String | 视频 ID |
streamUrl |
String | 视频的临时访问地址,支持 HTTP Range 请求,可直接在浏览器或播放器里打开 |
expiresIn |
Integer | streamUrl 的有效期,单位秒,目前为 900 |
mimeType |
String | 视频格式,如 video/mp4 |
sizeBytes |
Integer | 视频大小,单位字节 |
请求示例
Bash
1python3 call_eval.py GET DescribeEmbodiedEvalVideo evalId=em-6o004i76d88e videoId=v-ZW0tNm8wMDRpNzZkODhlL3ZpZGVvcy9saWJlcm8tbGliZXJvX3NwYXRpYWwvc2hhcmQwL3Rhc2swMDAwX2VwMDAwMC5tcDQ
响应示例
JSON
1{
2 "requestId": "7f8091a2-b3c4-4d56-ef7a-8b9c0d1e2f3a",
3 "videoId": "v-ZW0tNm8wMDRpNzZkODhlL3ZpZGVvcy9saWJlcm8tbGliZXJvX3NwYXRpYWwvc2hhcmQwL3Rhc2swMDAwX2VwMDAwMC5tcDQ",
4 "streamUrl": "https://aihc-eval-xxxx-bj.bj.bcebos.com/results/...?authorization=...",
5 "expiresIn": 900,
6 "mimeType": "video/mp4",
7 "sizeBytes": 1048576
8}
注意事项
streamUrl本身带有访问凭证,持有链接即可下载视频,不要转发给无关人员。过期后重新调用本接口获取。videos[].state为failed的视频没有可播放的文件,调用会返回 404。
错误码
| HTTP 状态码 | code | 场景 |
|---|---|---|
| 400 | InvalidParameter |
缺少 evalId 或 videoId;videoId 格式不对或不属于该任务 |
| 403 | Forbidden |
没有查看该任务的权限 |
| 404 | NotFound |
任务不存在;视频文件不存在 |
评价此篇文章
