AIOZ Stream Toolkit

Polar Sponsor
爱发电 赞助
.NET 9.0

响应用户对 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 字段。

完整上传流程(典型操作路径)

针对常规上传生命周期,请按以下顺序执行:

  1. 创建媒体对象(media object)
  2. 上传媒体分片(media part)
  3. 完成上传(complete upload)
  4. 获取媒体详情(fetch media detail)
  5. 输出状态及播放链接(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)

响应处理规范

  1. 从 scripts/ 目录中运行对应脚本。
  2. 媒体/搜索类脚本 返回原始 JSON:get_video_list、get_video_url_by_name、get_total_media、get_media_list
  3. 指标类脚本 返回结构化输出:
    • 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)
  4. 上传/管理类脚本:upload_video_file.sh 将逐阶段打印状态信息,并最终输出播放 URL
  5. 明确返回关键字段(如 ID、状态、URL、总量等)。若上传状态为 transcoding 或 URL 字段为空,请提示用户稍后重试检查。

错误处理

  • 401 错误:API 密钥无效。请提示用户校验 STREAM_PUBLIC_KEY 和 STREAM_SECRET_KEY 的正确性。
  • 参数缺失:各脚本均对入参进行校验,请确保传入完全符合要求的参数。
  • 404 错误:资源未找到(媒体 ID 或 livestream ID 无效)。
  • 500 错误:服务端异常;建议用户稍后重试。
  • 连接超时/被拒绝:API 接口可能暂时不可用;请重试,并确认 https://api.aiozstream.network/api/ 可正常访问。

交互流程示例

  1. 用户:“Upload my video to AIOZ Stream”
  2. 检查环境变量中是否存在 STREAM_PUBLIC_KEY 和 STREAM_SECRET_KEY(若缺失则向用户索取)
  3. 向用户询问视频文件路径与标题
  4. 执行命令:./scripts/upload_video_file.sh "FILE_PATH" "TITLE"
  5. 从脚本输出中提取 HLS/MP4 播放链接
  6. 将视频播放链接返回给用户

相关专题

更多
Navicat创建数据库教程
Navicat创建数据库教程

本专题整理Navicat创建数据库相关教程,介绍新建前的准备、基础设置和创建后的检查方法。内容兼顾入门学习及实际使用需求,帮助用户了解不同数据库类型下的操作差异,为后续建表、保存数据和日常管理提供参考。

2026.11.20

0

7

Navicat入门教程大全
Navicat入门教程大全

本专题整理Navicat入门教程,从认识软件界面到开展数据库操作,介绍初次使用需要了解的知识和方法。内容兼顾连接配置、数据管理及日常使用中的疑问,方便用户按学习进度查阅,为后续实践和独立操作打好基础。

2026.11.20

0

17

Navicat数据库连接配置指南
Navicat数据库连接配置指南

从确认数据库信息到建立可用连接,本专题串联Navicat连接数据库的相关知识和操作方法。既有初次配置时需要了解的基础内容,也有连接后的检查思路,方便用户按实际需求查阅教程,逐步熟悉数据库连接的设置流程。

2026.11.20

0

10

PHP8.6数组与数据处理教程
PHP8.6数组与数据处理教程

本专题汇总PHP8.6数组与数据处理教程,涵盖CSV读取和导出、引用遍历删除、array_filter回调模式、配置键名冲突、pathinfo文件名校验、GMP大整数进制转换及UTF-8正则筛选,说明升级兼容变化、输入范围和失败处理方法。

2026.11.20

0

8

PHP8.6升级迁移教程
PHP8.6升级迁移教程

本专题汇总PHP8.6升级迁移与弃用接口改造教程,涵盖反射调用、对象属性赋值、标识符更名、构造函数与__debugInfo调整,以及插件类名检查、常量导出、ArrayIterator排序、SPL和DTO查询参数转换,帮助梳理弃用提示并完成代码兼容改造。

2026.11.20

0

10

PHP8.6安装配置与FPM运维教程
PHP8.6安装配置与FPM运维教程

本专题汇总PHP8.6正式版安装部署与FPM运维教程,涵盖Linux并存安装、独立ini配置、扩展重新编译、Nginx切换与回滚、FPM状态监控和慢日志排查,以及环境变量、请求超时、OPcache刷新和预加载配置。

2026.11.20

0

10

Nginx CVE-2026-123007排查与防护指南
Nginx CVE-2026-123007排查与防护指南

Nginx HTTP/2漏洞该怎么修复?本专题围绕CVE-2026-123007,介绍安全版本升级、模块兼容检查和配置恢复方法,以及日志排查、权限设置等后续加固操作,方便你按实际部署情况查找对应教程。

2026.11.20

0

8

GoFrame框架Web开发与路由中间件
GoFrame框架Web开发与路由中间件

本专题聚焦GoFrame框架的Web开发,拆解路由注册与匹配规则、请求参数获取、参数校验与中间件执行顺序,说明统一响应、JWT鉴权、文件上传与接口文档生成的落地方式,并补充优雅重启与测试实践。

2026.11.17

0

15

GoFrame框架安装与gf命令行工具
GoFrame框架安装与gf命令行工具

本专题围绕GoFrame框架的安装与工具链配置展开,讲清Go版本要求、gf命令行的安装方式、代理镜像与依赖准备,说明项目初始化、热编译、交叉编译打包的做法,并整理安装阶段的常见报错与验证步骤。

2026.11.17

0

15

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
CentOS 官方文档
CentOS 官方文档

共0课时 | 0人学习

极客学院Java8新特性视频教程
极客学院Java8新特性视频教程

共17课时 | 4.3万人学习