响应用户对 AIOZ Stream API 的请求,使用提供的脚本上传视频、获取分析、管理媒体和创建直播。
AIOZ Stream 操作
功能概述
AIOZ Stream 操作是一项面向实际任务的技能,主要用于与 AIOZ Stream API 快速进行 API 密钥认证;提供一套集成的shat脚本, 自动调用 REST API;
核心要点
- 当使用此技能时。
- 它将相关步骤、工具调用和结果整理方式集中到统一流程中,帮助使用者更快完成目标并减少重复操作。
- 使用时应结合输入条件选择合适的执行方式,核对必要参数、依赖环境与输出内容,并按原始要求处理异常情况。
使用与执行
该技能适合需要稳定复用相关能力的场景,可作为自动化工作流的一部分,也便于后续检查、调整和扩展。从功能定位来看,该技能强调把分散的操作要求整理成清晰、可复用的处理流程,使用户能够围绕既定目标快速准备输入、选择执行方式并获得结构化结果。实际使用前应先确认任务范围、数据来源、运行环境、必要权限和关键参数,再依据技能说明逐步执行;
结果检查与注意事项
若输入条件不完整,应先补齐信息或采用保守配置,避免因错误假设导致结果偏离需求。执行过程中需要关注工具调用是否成功、接口或依赖是否可用、输出格式是否符合预期,并对异常提示、缺失字段和边界情况进行处理;涉及批量任务时,还应保存进度,避免中断后重复操作。
AIOZ Stream 操作
通过 API 密钥认证快速调用 AIOZ Stream API。本技能提供了一套集成的 Bash 脚本,可自动调用 REST API。
适用场景
- 用户希望在 AIOZ Stream 上上传或创建视频
- 用户提及“upload video”、“create video”、“aioz stream video”等关键词
- 用户希望查询分析数据、直播流密钥(livestream keys)或账户余额
- 用户希望获取其视频的 HLS/MP4 播放链接
- 用户希望搜索/列出媒体资源,或按名称查找视频
认证方式
本技能使用环境变量进行 API 密钥认证:
STREAM_PUBLIC_KEY:您的 AIOZ Stream 公钥(由平台提供)STREAM_SECRET_KEY:您的 AIOZ Stream 密钥(由平台提供)
凭证安全策略:
- 优先使用安全的环境变量注入方式提供凭证。
- 若缺失凭证,请向用户索取,并将其设为临时环境变量。
- 切勿在命令示例、日志或响应中硬编码密钥。
- 避免使用内联的一次性命令(inline one-off commands),尤其不得在其中直接暴露原始密钥(raw secrets)。
若当前 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 脚本。
脚本路由映射表(供 Clawbot 使用)
- 上传本地文件为视频:
./scripts/upload_video_file.sh FILE_PATH "TITLE" - 获取媒体列表(GET,支持可选查询参数):
./scripts/get_media_list.sh [SEARCH] [PAGE] - 通过 POST 请求体获取媒体列表(含 search/page 参数):
./scripts/get_total_media.sh [SEARCH] [PAGE] - 通过 POST 空请求体
{}获取全部媒体:./scripts/get_video_list.sh - 通过 POST 请求体按名称搜索媒体:
./scripts/get_video_url_by_name.sh "VIDEO_NAME" - 创建直播流密钥(livestream key):
./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)
1. 视频上传(默认凭证安全流程)
使用该脚本可自动完成视频对象创建、文件上传与流程收尾:
./scripts/upload_video_file.sh "/path/to/video.mp4" "Video Title"
脚本实际行为说明:
- 仅接受本地文件路径作为输入。
- 依据文件扩展名(并在可能时结合 MIME 类型)校验视频有效性。
- 文件必须存在于本地系统中。
2. 分析数据与用量查询
如需获取指标数据或账户用量信息,请参考以下脚本:
- 用量数据:
./scripts/get_usage_data.sh FROM(dd/mm/yyyy) TO(dd/mm/yyyy)- 调用接口:
GET /analytics/data?from=...&to=...&interval=hour FROM/TO必须为dd/mm/yyyy格式(脚本内部将自动转换为 Unix 时间戳)
- 调用接口:
- 聚合指标:
./scripts/get_aggregate_metric.sh TYPE FROM(dd/mm/yyyy) TO(dd/mm/yyyy)- 返回结果:所选媒体类型的总观看时长(watch_time sum)与总播放次数(view_count)
TYPE必须为video或audio
- 细分指标:
./scripts/get_breakdown_metric.sh TYPE FROM(dd/mm/yyyy) TO(dd/mm/yyyy)- 返回结果:设备类型(device type)、操作系统(Operating system)、国家(Country)、浏览器(Browser)四个维度的统计分布(含总计数与详细数据数组)
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 时间戳)
3. 媒体与直播流管理
如需搜索已有媒体、查询余额或创建密钥,请参考以下脚本:
- 列出媒体:
./scripts/get_media_list.sh [SEARCH] [PAGE] - 获取媒体总数:
./scripts/get_total_media.sh [SEARCH] [PAGE] - 获取视频列表:
./scripts/get_video_list.sh - 按名称搜索视频 URL:
./scripts/get_video_url_by_name.sh "Video Name" - 创建直播流密钥(livestream key):
./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 字段。
完整上传流程(典型操作路径)
针对常规上传生命周期,请按以下顺序执行:
- 创建媒体对象(media object)
- 上传媒体分片(media part)
- 完成上传(complete upload)
- 获取媒体详情(fetch media detail)
- 输出状态及播放链接(
hls_player_url、hls_url、mp4_url)
若手动使用 curl,核心上传流程即为以下前三步。
步骤 1:创建视频对象
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,用于后续步骤。
步骤 2:上传媒体分片
将实际视频文件二进制内容上传至已创建的视频对象。
首先获取文件大小并计算 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 哈希值
步骤 3:完成上传
媒体分片上传成功后,调用完成接口以结束上传流程:
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,并返回给用户。
自定义上传配置参考(适用于直接调用 API 实现自定义逻辑)
画质预设(resolution 字段):
standard— 标准画质good— 良好画质highest— 最高画质lossless— 无损画质
流媒体格式(type 字段):
hls— HTTP Live Streaming(容器格式:mpegts或mp4)dash— Dynamic Adaptive Streaming(容器格式:fmp4)
响应处理规范
- 从
scripts/目录中运行对应脚本。 - 媒体/搜索类脚本 返回原始 JSON:
get_video_list、get_video_url_by_name、get_total_media、get_media_list - 指标类脚本 返回结构化输出:
get_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将逐阶段打印状态信息,并最终输出播放 URL - 明确返回关键字段(如 ID、状态、URL、总量等)。若上传状态为
transcoding或 URL 字段为空,请提示用户稍后重试检查。
错误处理
- 401 错误:API 密钥无效。请提示用户校验
STREAM_PUBLIC_KEY和STREAM_SECRET_KEY的正确性。 - 参数缺失:各脚本均对入参进行校验,请确保传入完全符合要求的参数。
- 404 错误:资源未找到(媒体 ID 或 livestream ID 无效)。
- 500 错误:服务端异常;建议用户稍后重试。
- 连接超时/被拒绝:API 接口可能暂时不可用;请重试,并确认
https://api.aiozstream.network/api/可正常访问。
交互流程示例
- 用户:“Upload my video to AIOZ Stream”
- 检查环境变量中是否存在
STREAM_PUBLIC_KEY和STREAM_SECRET_KEY(若缺失则向用户索取) - 向用户询问视频文件路径与标题
- 执行命令:
./scripts/upload_video_file.sh "FILE_PATH" "TITLE" - 从脚本输出中提取 HLS/MP4 播放链接
- 将视频播放链接返回给用户
热门AI工具
相关专题
本专题整理Navicat创建数据库相关教程,介绍新建前的准备、基础设置和创建后的检查方法。内容兼顾入门学习及实际使用需求,帮助用户了解不同数据库类型下的操作差异,为后续建表、保存数据和日常管理提供参考。
0
2026.11.20
本专题整理Navicat入门教程,从认识软件界面到开展数据库操作,介绍初次使用需要了解的知识和方法。内容兼顾连接配置、数据管理及日常使用中的疑问,方便用户按学习进度查阅,为后续实践和独立操作打好基础。
0
2026.11.20
从确认数据库信息到建立可用连接,本专题串联Navicat连接数据库的相关知识和操作方法。既有初次配置时需要了解的基础内容,也有连接后的检查思路,方便用户按实际需求查阅教程,逐步熟悉数据库连接的设置流程。
0
2026.11.20
本专题汇总PHP8.6数组与数据处理教程,涵盖CSV读取和导出、引用遍历删除、array_filter回调模式、配置键名冲突、pathinfo文件名校验、GMP大整数进制转换及UTF-8正则筛选,说明升级兼容变化、输入范围和失败处理方法。
0
2026.11.20
本专题汇总PHP8.6升级迁移与弃用接口改造教程,涵盖反射调用、对象属性赋值、标识符更名、构造函数与__debugInfo调整,以及插件类名检查、常量导出、ArrayIterator排序、SPL和DTO查询参数转换,帮助梳理弃用提示并完成代码兼容改造。
0
2026.11.20
本专题汇总PHP8.6正式版安装部署与FPM运维教程,涵盖Linux并存安装、独立ini配置、扩展重新编译、Nginx切换与回滚、FPM状态监控和慢日志排查,以及环境变量、请求超时、OPcache刷新和预加载配置。
0
2026.11.20
Nginx HTTP/2漏洞该怎么修复?本专题围绕CVE-2026-123007,介绍安全版本升级、模块兼容检查和配置恢复方法,以及日志排查、权限设置等后续加固操作,方便你按实际部署情况查找对应教程。
0
2026.11.20
本专题聚焦GoFrame框架的Web开发,拆解路由注册与匹配规则、请求参数获取、参数校验与中间件执行顺序,说明统一响应、JWT鉴权、文件上传与接口文档生成的落地方式,并补充优雅重启与测试实践。
0
2026.11.17
本专题围绕GoFrame框架的安装与工具链配置展开,讲清Go版本要求、gf命令行的安装方式、代理镜像与依赖准备,说明项目初始化、热编译、交叉编译打包的做法,并整理安装阶段的常见报错与验证步骤。
0
2026.11.17
热门下载
相关下载
精品课程
共0课时 | 0人学习
共17课时 | 4.3万人学习