1{
2  "log_id": "20250622150000XXXX",
3  "error_code": 0,
4  "error_message": "success",
5  "data": {}
6}

1curl --location 'https://aip.baidubce.com/rpc/2.0/speech/publiccloudspeech/v1/echo/footage/upload' \
2--header 'authorization: Bearer xxxxxxx' \
3--header 'Content-Type: application/json' \
4--data '{
5    "file_name": "video_sample.mp4"
6}'

1{
2  "log_id": "20250622150000XXXX",
3  "error_code": 0,
4  "error_message": "success",
5  "data": {
6    "access_key_id": "STSxxxxxxxxxxxx",
7    "secret_access_key": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
8    "session_token": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
9    "expiration": "2025-06-22T16:00:00Z",
10    "resource": "prefix/projects/100001/550e8400-e29b-41d4-a716-446655440000/video_sample.mp4",
11    "bucket_name": "echo-prod",
12    "endpoint": "https://bos.bj.bcebos.com"
13  }
14}

1// 创建素材
2{
3  "action_type": "create",
4  "create": {
5    "footage_name": "角色A参考视频",
6    "footage_url": "https://bucket.bj.bcebos.com/path/to/footage.mp4",
7    "footage_desc": "角色A 的参考素材"
8  }
9}
10
11// 更新素材
12{
13  "action_type": "update",
14  "update": { "footage_id": 123456, "footage_name": "角色A参考视频-新版", "footage_desc": "更新后的描述" }
15}
16
17// 查询列表
18{
19  "action_type": "list",
20  "list": { "page": 1, "page_size": 20, "sort": "desc" }
21}
22
23// 查询详情
24{
25  "action_type": "detail",
26  "detail": { "footage_id": 123456 }
27}
28
29// 删除
30{
31  "action_type": "delete",
32  "delete": { "footage_ids": [123456, 123457] }
33}

1// list
2{
3  "log_id": "20250622150000XXXX",
4  "error_code": 0,
5  "error_message": "success",
6  "data": {
7    "list": {
8      "page": 1,
9      "page_size": 20,
10      "total": 35,
11      "list": [
12        {
13          "footage_id": 123456,
14          "footage_name": "角色A参考视频",
15          "footage_url": "https://bucket.bj.bcebos.com/path/...?authorization=...",
16          "footage_desc": "角色A 的参考素材",
17          "create_time": "2025-06-22 15:00:00"
18        }
19      ]
20    }
21  }
22}
23
24// detail
25{ "log_id": "...", "error_code": 0, "error_message": "success",
26  "data": { "detail": { "footage_id": 123456, "footage_name": "角色A参考视频",
27    "footage_url": "https://...", "footage_desc": "...", "create_time": "2025-06-22 15:00:00" } } }
28
29// create / update
30{ "log_id": "...", "error_code": 0, "error_message": "success", "data": { "create": { "footage_id": 123456 } } }
31
32// delete
33{ "log_id": "...", "error_code": 0, "error_message": "success", "data": { "delete": { "footage_ids": [123456, 123457] } } }

1// 1) single_video
2{
3  "action_type": "single_video",
4  "single_video": {
5    "series_id": 0,
6    "series_name": "我的剧集",
7    "series_desc": "可选",
8    "video_url": "https://bucket.bj.bcebos.com/path/input.mp4",
9    "video_name": "第一集",
10    "video_desc": "第一集",
11    "source_language": "zh",
12    "target_language": "en",
13    "analysis_config": { "face_type": "normal" },
14    "subtitle_config": { "extractor_type": "advance", "subtitle_remove_mode": "none" },
15    "translate_config": {},
16    "dubbing_config": { "with_original_vocal": false }
17  }
18}

1// 2) batch_video
2{
3  "action_type": "batch_video",
4  "batch_video": {
5    "series_name": "我的剧集",
6    "source_language": "zh",
7    "target_language": "en",
8    "video_list": [
9      { "video_url": "https://.../01.mp4", "video_name": "第一集" },
10      { "video_url": "https://.../02.mp4", "video_name": "第二集" }
11    ],
12    "analysis_config": {},
13    "subtitle_config": { "extractor_type": "advance", "subtitle_remove_mode": "none" },
14    "translate_config": {},
15    "dubbing_config": {}
16  }
17}
18
19// 3) single_task
20{
21  "action_type": "single_task",
22  "single_task": {
23    "video_id": 100001,
24    "task_type": "subtitle",
25    "subtitle_config": { "extractor_type": "advance", "subtitle_remove_mode": "none" }
26  }
27}

1// single_video
2{ "log_id": "...", "error_code": 0, "error_message": "success",
3  "data": { "all_task": { "series_id": 1001, "video_id": 200001, "task_id": 3000001 } } }
4
5// batch_video
6{ "log_id": "...", "error_code": 0, "error_message": "success",
7  "data": { "batch_task": { "series_id": 1001, "list": [
8      { "series_id": 1001, "video_id": 200001, "task_id": 3000001 },
9      { "series_id": 1001, "video_id": 200002, "task_id": 3000002 }
10  ] } } }
11
12// single_task
13{ "log_id": "...", "error_code": 0, "error_message": "success",
14  "data": { "single_task": { "video_id": 0, "task_id": 3000010 } } }

1// 查询视频列表
2{ "action_type": "list_video", "list_video": { "page": 1, "page_size": 20, "sort": "desc" } }
3
4// 查询任务详情（按 video_id）
5{ "action_type": "detail_task", "detail_task": { "video_id": 200001 } }
6
7// 更新任务结果
8{
9  "action_type": "update_task_result",
10  "update_task_result": {
11    "task_id": 3000001,
12    "task_status": "checked",
13    "subtitle_result": {
14      "subtitles": [
15        { "id": "473e1c93-1b8c-46", "text": "直到死去5年的丈夫站在我面前的时候",
16          "start_time": 0.3, "end_time": 2.7,
17          "character_id": "1000261_ebee37e3-d9fe-48_cluster_0", "language": "zh" },
18        { "id": "a238d69d-3d9e-43", "text": "我才知道原来他没死",
19          "start_time": 2.9, "end_time": 4.83,
20          "character_id": "1000261_ebee37e3-d9fe-48_cluster_0", "language": "zh" }
21      ]
22    }
23  }
24}
25
26// 确认任务结果
27{ "action_type": "confirm_task_result", "confirm_task_result": { "task_id": 3000001 } }
28
29// 删除任务
30{ "action_type": "delete_task", "delete_task": { "task_ids": [3000001, 3000002] } }
31
32// 导出合成视频
33{ "action_type": "export_task", "export_task": { "task_id": 3000100 } }

1// list_video
2{ "log_id": "...", "error_code": 0, "error_message": "success",
3  "data": { "list": { "page": 1, "page_size": 20, "total": 1, "list": [
4    { "video_id": 200001, "name": "第一集",
5      "video_url": "https://.../input.mp4?authorization=...",
6      "source_language": "zh", "target_language": "en",
7      "duration": 600, "description": "",
8      "create_time": "2025-06-22 15:00", "update_time": "2025-06-22 15:05" }
9  ] } } }
10
11// detail_task
12{ "log_id": "...", "error_code": 0, "error_message": "success",
13  "data": { "detail": {
14    "video_id": 200001,
15    "task_id": 0,
16    "analysis": [
17      { "video_id": 200001, "task_id": 3000001, "task_type": "analysis",
18        "task_status": "done", "need_check": false,
19        "created_time": "2025-06-22 15:00:00", "updated_time": "2025-06-22 15:03:00" }
20    ],
21    "subtitle": [], "translation": [], "dubbing": [], "compose": []
22  } } }
23
24// update_task_result / confirm_task_result
25{ "log_id": "...", "error_code": 0, "error_message": "success",
26  "data": { "update_task_result": { "task_id": 3000001 } } }
27
28// delete_task
29{ "log_id": "...", "error_code": 0, "error_message": "success",
30  "data": { "delete": { "task_ids": [3000001, 3000002] } } }
31
32// export_task
33{ "log_id": "...", "error_code": 0, "error_message": "success",
34  "data": { "export": { "task_id": 3000100, "final_url": "https://.../final.mp4?authorization=..." } } }

1// 重试字幕任务，并调整提取器与擦除模式
2{
3  "task_id": 3000002,
4  "subtitle_config": { "extractor_type": "advance", "subtitle_remove_mode": "advanced", "need_human_check": false }
5}
6
7// 重试失败的分析任务（failed 状态不计重试次数）
8{
9  "task_id": 3000001,
10  "analysis_config": { "disable_face_detection": true, "need_human_check": false }
11}
12
13// 仅重试，不调整配置
14{ "task_id": 3000003 }

1{
2  "log_id": "20250622150000XXXX",
3  "error_code": 0,
4  "error_message": "success",
5  "data": {
6    "task_id": 3000002
7  }
8}

1"""通过 BOS 的 STS 临时凭证上传文件并返回文件链接"""
2
3import os
4import sys
5import time
6from io import BytesIO
7from baidubce.bce_client_configuration import BceClientConfiguration
8from baidubce.auth.bce_credentials import BceCredentials
9from baidubce.services.bos.bos_client import BosClient
10
11# ===== 配置区域：填入 /footage/upload 返回的 STS 临时凭证 =====
12STS_ACCESS_KEY_ID = "<access_key_id>"
13STS_SECRET_ACCESS_KEY = "<secret_access_key>"
14STS_SESSION_TOKEN = "<session_token>"
15BOS_HOST = "http://bj.bcebos.com"      # 对应响应中的 endpoint
16BUCKET_NAME = "<bucket_name>"          # 对应响应中的 bucket_name
17
18
19def upload_file(local_file_path, object_key=None):
20    if not os.path.exists(local_file_path):
21        print(f"文件不存在: {local_file_path}")
22        return None
23
24    if object_key is None:
25        object_key = os.path.basename(local_file_path)
26
27    bos_config = BceClientConfiguration(
28        credentials=BceCredentials(STS_ACCESS_KEY_ID, STS_SECRET_ACCESS_KEY),
29        endpoint=BOS_HOST,
30        security_token=STS_SESSION_TOKEN
31    )
32    bos_client = BosClient(bos_config)
33
34    # 大于 1GB 用分块上传，否则用简单上传
35    file_size = os.path.getsize(local_file_path)
36    max_simple_size = 1 * 1024 * 1024 * 1024  # 1GB
37
38    if file_size >= max_simple_size:
39        part_size = 100 * 1024 * 1024  # 每块 100MB
40        total_parts = (file_size + part_size - 1) // part_size
41        upload_id = bos_client.initiate_multipart_upload(BUCKET_NAME, object_key).upload_id
42
43        part_list = []
44        with open(local_file_path, 'rb') as f:
45            part_number = 1
46            while True:
47                data = f.read(part_size)
48                if not data:
49                    break
50                response = bos_client.upload_part(
51                    BUCKET_NAME, object_key, upload_id, part_number, len(data), BytesIO(data))
52                part_list.append({"partNumber": part_number, "eTag": response.metadata.etag})
53                print(f"  [{part_number}/{total_parts}] 分块上传完成")
54                part_number += 1
55
56        bos_client.complete_multipart_upload(BUCKET_NAME, object_key, upload_id, part_list)
57    else:
58        bos_client.put_object_from_file(BUCKET_NAME, object_key, local_file_path)
59
60    # 生成预签名 URL（1 小时有效）
61    timestamp = int(time.time())
62    signed_url = bos_client.generate_pre_signed_url(
63        BUCKET_NAME, object_key, timestamp, expiration_in_seconds=3600).decode('utf-8')
64    print(f"上传成功，签名链接（1 小时有效）：\n{signed_url}")
65    return signed_url
66
67
68if __name__ == "__main__":
69    if len(sys.argv) < 2:
70        print("用法: python upload_by_bos_sts.py <文件路径> [对象路径]")
71        sys.exit(1)