响应用户对 AIOZ Stream API 的请求,使用提供的脚本上传视频、获取分析、管理媒体和创建直播。
AIOZ Stream 操作是一项面向实际任务的技能,主要用于与 AIOZ Stream API 快速进行 API 密钥认证;提供一套集成的shat脚本, 自动调用 REST API;
该技能适合需要稳定复用相关能力的场景,可作为自动化工作流的一部分,也便于后续检查、调整和扩展。从功能定位来看,该技能强调把分散的操作要求整理成清晰、可复用的处理流程,使用户能够围绕既定目标快速准备输入、选择执行方式并获得结构化结果。实际使用前应先确认任务范围、数据来源、运行环境、必要权限和关键参数,再依据技能说明逐步执行;
若输入条件不完整,应先补齐信息或采用保守配置,避免因错误假设导致结果偏离需求。执行过程中需要关注工具调用是否成功、接口或依赖是否可用、输出格式是否符合预期,并对异常提示、缺失字段和边界情况进行处理;涉及批量任务时,还应保存进度,避免中断后重复操作。
通过 API 密钥认证快速调用 AIOZ Stream API。本技能提供了一套集成的 Bash 脚本,可自动调用 REST API。
本技能使用环境变量进行 API 密钥认证:
STREAM_PUBLIC_KEY:您的 AIOZ Stream 公钥(由平台提供)STREAM_SECRET_KEY:您的 AIOZ Stream 密钥(由平台提供)凭证安全策略:
若当前 Shell 会话中未设置凭证,请在运行脚本前一次性配置:
export STREAM_PUBLIC_KEY="YOUR_STREAM_PUBLIC_KEY" export STREAM_SECRET_KEY="YOUR_STREAM_SECRET_KEY"
脚本使用的请求头映射关系如下:
STREAM_PUBLIC_KEY → stream-public-key 请求头STREAM_SECRET_KEY → stream-secret-key 请求头该设计可避免凭证反复出现在命令历史记录中,降低意外泄露风险。
当用户提出某项功能需求时,请调用 scripts/ 目录下的对应 Bash 脚本。
./scripts/upload_video_file.sh FILE_PATH "TITLE"./scripts/get_media_list.sh [SEARCH] [PAGE]./scripts/get_total_media.sh [SEARCH] [PAGE]{} 获取全部媒体:./scripts/get_video_list.sh./scripts/get_video_url_by_name.sh "VIDEO_NAME"./scripts/create_livestream_key.sh "KEY_NAME"./scripts/get_balance.sh./scripts/get_usage_data.sh FROM(dd/mm/yyyy) TO(dd/mm/yyyy)./scripts/get_aggregate_metric.sh TYPE FROM(dd/mm/yyyy) TO(dd/mm/yyyy)./scripts/get_breakdown_metric.sh TYPE FROM(dd/mm/yyyy) TO(dd/mm/yyyy)./scripts/analytic_data.sh TYPE FROM(dd/mm/yyyy) TO(dd/mm/yyyy)使用该脚本可自动完成视频对象创建、文件上传与流程收尾:
./scripts/upload_video_file.sh "/path/to/video.mp4" "Video Title"
脚本实际行为说明:
如需获取指标数据或账户用量信息,请参考以下脚本:
./scripts/get_usage_data.sh FROM(dd/mm/yyyy) TO(dd/mm/yyyy)GET /analytics/data?from=...&to=...&interval=hourFROM/TO 必须为 dd/mm/yyyy 格式(脚本内部将自动转换为 Unix 时间戳)./scripts/get_aggregate_metric.sh TYPE FROM(dd/mm/yyyy) TO(dd/mm/yyyy)TYPE 必须为 video 或 audio./scripts/get_breakdown_metric.sh TYPE FROM(dd/mm/yyyy) TO(dd/mm/yyyy)TYPE 必须为 video 或 audio./scripts/analytic_data.sh TYPE FROM(dd/mm/yyyy) TO(dd/mm/yyyy)TYPE 必须为 video 或 audio日期格式说明:
FROM 和 TO 必须采用 dd/mm/yyyy 格式(脚本内部会自动转换为 Unix 时间戳)如需搜索已有媒体、查询余额或创建密钥,请参考以下脚本:
./scripts/get_media_list.sh [SEARCH] [PAGE]./scripts/get_total_media.sh [SEARCH] [PAGE]./scripts/get_video_list.sh./scripts/get_video_url_by_name.sh "Video Name"./scripts/create_livestream_key.sh "Key Name"./scripts/get_balance.sh注意事项:
get_video_list.sh 当前返回所有媒体(即向 POST /media 发送空请求体),并非严格限定为视频类型。get_video_url_by_name.sh 当前仅返回搜索结果 JSON;不会自动提取并返回单一 URL 字段。针对常规上传生命周期,请按以下顺序执行:
hls_player_url、hls_url、mp4_url)若手动使用 curl,核心上传流程即为以下前三步。
curl -s -X POST 'https://api.aiozstream.network/api/media/create'
-H "stream-public-key: $STREAM_PUBLIC_KEY"
-H "stream-secret-key: $STREAM_SECRET_KEY"
-H 'Content-Type: application/json'
-d '{
"title": "VIDEO_TITLE",
"type": "video"
}'
响应中请提取 data.id 字段值,记为 VIDEO_ID,用于后续步骤。
将实际视频文件二进制内容上传至已创建的视频对象。
首先获取文件大小并计算 MD5 哈希值:
# 获取文件大小(跨平台兼容)
FILE_SIZE=$(stat -f%z /path/to/video.mp4 2>/dev/null || stat -c%s /path/to/video.mp4)
END_POS=$((FILE_SIZE - 1))
# 计算 MD5 哈希值
HASH=$(md5sum /path/to/video.mp4 | awk '{print $1}')
随后使用 multipart form-data 方式上传,并携带 Content-Range 请求头:
curl -s -X POST "https://api.aiozstream.network/api/media/VIDEO_ID/part" -H "stream-public-key: $STREAM_PUBLIC_KEY" -H "stream-secret-key: $STREAM_SECRET_KEY" -H "Content-Range: bytes 0-$END_POS/$FILE_SIZE" -F "file=@/path/to/video.mp4" -F "index=0" -F "hash=$HASH"
重要提示: Content-Range 请求头为必填项,否则上传将失败。格式为:bytes {start}-{end}/{total_size}。
form-data 字段说明:
file:视频文件二进制内容(使用 @/path/to/video.mp4 表示)index:0(单分片上传场景)hash:该分片文件的 MD5 哈希值媒体分片上传成功后,调用完成接口以结束上传流程:
curl -s -X GET "https://api.aiozstream.network/api/media/VIDEO_ID/complete" -H 'accept: application/json' -H "stream-public-key: $STREAM_PUBLIC_KEY" -H "stream-secret-key: $STREAM_SECRET_KEY"
此操作将触发转码(transcoding)。至此,上传流程视为成功。
上传完成后,调用媒体详情接口以获取流媒体播放地址:
curl -s "https://api.aiozstream.network/api/media/VIDEO_ID" -H "stream-public-key: $STREAM_PUBLIC_KEY" -H "stream-secret-key: $STREAM_SECRET_KEY"
解析响应,在 assets 字段中定位 HLS 或 MP4 URL,并返回给用户。
resolution 字段):standard — 标准画质good — 良好画质highest — 最高画质lossless — 无损画质type 字段):hls — HTTP Live Streaming(容器格式:mpegts 或 mp4)dash — Dynamic Adaptive Streaming(容器格式:fmp4)scripts/ 目录中运行对应脚本。get_video_list、get_video_url_by_name、get_total_media、get_media_listget_aggregate_metric.sh:两个带标签的输出项(Watch Time Sum、View Count)get_breakdown_metric.sh:四个带标签的 JSON 区块(=== device_type ===、=== operator_system ===、=== country ===、=== browser ===)analytic_data.sh:聚合指标 + 细分指标的组合输出get_usage_data.sh:原始 JSON 响应,已做美化排版(pretty-printed)upload_video_file.sh 将逐阶段打印状态信息,并最终输出播放 URLtranscoding 或 URL 字段为空,请提示用户稍后重试检查。STREAM_PUBLIC_KEY 和 STREAM_SECRET_KEY 的正确性。https://api.aiozstream.network/api/ 可正常访问。STREAM_PUBLIC_KEY 和 STREAM_SECRET_KEY(若缺失则向用户索取)./scripts/upload_video_file.sh "FILE_PATH" "TITLE"相关专题
热门下载
相关下载
精品课程
共0课时 | 0人学习
共17课时 | 4.3万人学习