@api.video/nodejs-client

中文文档
2.6.8发布于 2024/11/08MITTypeScriptESM + CJS近 30 天下载 1.2万

api.video nodejs API 客户端

中文使用文档
文档目录14 节
  1. 目录
  2. 项目说明
  3. 开始
  4. 安装
  5. 移徙
  6. 发展
  7. 代码样本
  8. 文档
  9. API 终点
  10. 模型
  11. 限制费率
  12. 授权
  13. 你从这个API客户端得到了使用吗?
  14. 捐款

badge   badge   badge

api.video Node.js 客户端

视频 是产品制造者的视频基础设施。 闪电快视频 API 用于在您的应用程序中集成,缩放,并管理点播后低空直播功能.

目录

项目说明

api.video的Java Node.js是一个轻量级客户端,构建于 TypeScript 简化了编码程序。 弹簧文件是为你处理的, 以及重新刷新您的符号.

开始

安装

与 npm数字 :

npm install @api.video/nodejs-client --save

...或者说 yarn数字 :

yarn add @api.video/nodejs-client

移徙

如果你来自 @api.video/nodejs-sdk (英语) 确保阅读我们的 移徙指南 先说.

发展

要构建和编译用于 Javascript 的打字源 :

npm install
npm run build

代码样本

const ApiVideoClient = require('@api.video/nodejs-client');
// or: import ApiVideoClient from '@api.video/nodejs-client';

(async () => {
    try {
        const client = new ApiVideoClient({ apiKey: "YOUR_API_KEY" });

        // create a video
        const videoCreationPayload = {
            title: "Maths video", // The title of your new video.
            description: "A video about string theory.", // A brief description of your video.
        };
        const video = await client.videos.create(videoCreationPayload);

        // upload a video file into the video container
        await client.videos.upload(video.videoId, "my-video-file.mp4");
    } catch (e) {
        console.error(e);
    }
})();

文档

API 终点

分析学

方法说明HTTP 请求
获得分类计量( )检索汇总指标获取 /data/metrics/{metric}/{aggregation}
获得分解量( C)在分解维度时检索度量衡获取 /data/buckets/{metric}/{breakdown}
获取计量全时 ()随着时间的推移检索衡量标准获取 /data/timeseries/{metric}

说明Api

方法说明HTTP 请求
上传( )上传标题邮政 /videos/{videoId}/captions/{language}
获取()获取标题获取 /videos/{videoId}/captions/{language}
更新()更新标题帕齐 /videos/{videoId}/captions/{language}
删除( )删除标题迪莱特 /videos/{videoId}/captions/{language}
列表( )列出视频标题获取 /videos/{videoId}/captions

章节Api

方法说明HTTP 请求
上传( )上传一章邮政 /videos/{videoId}/chapters/{language}
获取()获取一章获取 /videos/{videoId}/chapters/{language}
删除( )删除一章迪莱特 /videos/{videoId}/chapters/{language}
列表( )列出视频章节获取 /videos/{videoId}/chapters

LiveStreams 亚庇

方法说明HTTP 请求
创建()创建活流邮政 /live-streams
获取()获取活流获取 /live-streams/{liveStreamId}
更新()更新实时流帕齐 /live-streams/{liveStreamId}
删除( )删除活流迪莱特 /live-streams/{liveStreamId}
列表( )列出所有活流获取 /live-streams
上传Thumbnail ()上传缩略图邮政 /live-streams/{liveStreamId}/thumbnail
删除 Thumbnail ()删除缩略图迪莱特 /live-streams/{liveStreamId}/thumbnail
完整( )完成一个直播流点 /live-streams/{liveStreamId}/complete

玩家主题Api

方法说明HTTP 请求
创建()创建玩家邮政 /players
获取()获取玩家获取 /players/{playerId}
更新()更新玩家帕齐 /players/{playerId}
删除( )删除玩家迪莱特 /players/{playerId}
列表( )列出所有玩家主题获取 /players
上传Logo ()上传标志邮政 /players/{playerId}/logo
删除Logo ()删除标志迪莱特 /players/{playerId}/logo

摘要Api

方法说明HTTP 请求
创建()生成视频摘要邮政 /summaries
更新()更新概要细节帕齐 /summaries/{summaryId}/source
删除( )删除视频摘要迪莱特 /summaries/{summaryId}
列表( )清单摘要获取 /summaries
获取简要来源( C)获取摘要细节获取 /summaries/{summaryId}/source

标签Api

方法说明HTTP 请求
列表( )列出所有视频标签获取 /tags

上传托肯斯Api

方法说明HTTP 请求
创建Token ()生成上传符号邮政 /upload-tokens
获取Token ()获取上传令牌获取 /upload-tokens/{uploadToken}
删除 Token ()删除上传符号迪莱特 /upload-tokens/{uploadToken}
列表( )列出所有活动上传符号获取 /upload-tokens

视频Api

方法说明HTTP 请求
创建()创建视频对象邮政 /videos
上传( )上传视频邮政 /videos/{videoId}/source
用 Upload Token () 上传使用授权的上传令牌上传邮政 /upload
获取()获取视频对象获取 /videos/{videoId}
更新()更新视频对象帕齐 /videos/{videoId}
删除( )删除视频对象迪莱特 /videos/{videoId}
列表( )列出所有视频对象获取 /videos
上传Thumbnail ()上传缩略图邮政 /videos/{videoId}/thumbnail
选择Thumbnail( )设置缩略图帕齐 /videos/{videoId}/thumbnail
被丢弃 ()获取已丢弃的视频对象获取 /discarded/videos/{videoId}
获取状态( C)获取视频状态和细节获取 /videos/{videoId}/status
列表已丢弃 ()列出所有已丢弃的视频对象获取 /discarded/videos
更新已丢弃( C)更新已丢弃的视频对象帕齐 /discarded/videos/{videoId}

水上标记Api

方法说明HTTP 请求
上传( )上传水印邮政 /watermarks
删除( )删除一个水印迪莱特 /watermarks/{watermarkId}
列表( )列出所有水印获取 /watermarks

网络用户

方法说明HTTP 请求
创建()创建 Webhook邮政 /webhooks
获取()获取 Webhook 细节获取 /webhooks/{webhookId}
删除( )删除一个 Webhook迪莱特 /webhooks/{webhookId}
列表( )列出所有网点获取 /webhooks

模型

限制费率

api.video执行限制费率,以确保服务的公平使用和稳定性。 API为您提出的任何 API 请求提供响应头中的速率限制值. /auth终点是唯一没有费率限制的路线.

在这个Node.js客户端中,您可以通过使用 *WithResponseHeaders() 方法的版本。 这些方法既返回反应体,又返回信头,允许您检查 X-RateLimit-Limit, (中文(简体) ), X-RateLimit-Remaining,以及 X-RateLimit-Retry-After 要了解您当前利率限制状态的页眉 .

更多信息,请访问 API 参考。 。 。 .

以下是如何使用这些方法的例子:

const client = new ApiVideoClient({ apiKey: "YOUR_API_KEY" });
const { body: videos, headers } = await client.videos.listWithResponseHeaders();
console.log('Rate Limit:', headers['x-ratelimit-limit']);
console.log('Rate Limit Remaining:', headers['x-ratelimit-remaining']);
console.log('Rate Limit Retry after:', headers['x-ratelimit-retry-after']);

授权

API 密钥

多数终点需要使用我们描述的API关键机制进行认证 文档。 。 。 . 访问符生成机制由客户端自动处理.

您只需要提供一个 API 键, 当即时 ApiVideoClient :

const client = new ApiVideoClient({ apiKey: "YOUR_API_KEY" });

获取访问符

如果您需要访问使用 API 密钥获得的存取键值, 您可以使用客户端的获取 AccessToken () 方法 :

const client = new ApiVideoClient({ apiKey: "YOUR_API_KEY" });
const accessToken = await client.getAccessToken();

公共终点

一些端点不需要认证. 这些可以使用没有 API 键的 ApiVideoClient 即时调用:

const client = new ApiVideoClient();

你从这个API客户端得到了使用吗?

请花点时间给客户留下一颗星星

这有助于其他用户找到客户,也帮助我们了解哪些客户最受欢迎. 谢谢!

捐款

由于这个API客户端是由OpenAPI描述生成的,我们不能接受直接向寄存器提出的拉取请求. 如果你想贡献,你可以打开拉 请求我们的仓库 客户端生成器。否则,您也可以简单地打开一个问题,详述您在这个寄存器库中的需要.

版本与发布记录

@api.video/nodejs-client 共发布 46 个版本,首次发布于 2021/05/25;过去 12 个月发布了 0 个版本。

版本发布日期距今
2.6.8latest2024/11/082 年前
2.6.72024/11/042 年前
2.6.62024/10/212 年前
2.6.52024/10/172 年前
2.6.42024/10/082 年前
2.6.32024/10/022 年前

关于 @api.video/nodejs-client 的常见问题

@api.video/nodejs-client 是什么?

api.video nodejs API 客户端

如何安装 @api.video/nodejs-client?

在项目目录运行 npm install @api.video/nodejs-client,或使用 pnpm add / yarn add / bun add。

@api.video/nodejs-client 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@api.video/nodejs-client 支持 ESM 还是 CommonJS?

同时提供 ES Module 与 CommonJS 入口,import 和 require() 都可以使用,打包工具会自动选择合适的版本。

@api.video/nodejs-client 可以商用吗?

@api.video/nodejs-client 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

@api.video/nodejs-client 的下载量有多少?

根据 npm 官方下载统计,@api.video/nodejs-client 在 2026/10/06 – 2026/11/04 这 30 天内被下载 12,074 次,日均约 402 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@api.video/nodejs-client 还在维护吗?

最新版本 2.6.8 发布于 2024/11/08(2 年前);至今共发布 46 个版本,其中过去 12 个月发布了 0 个;首次发布于 2021/05/25。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。