# @azure/cognitiveservices-customvision-training 中文文档

规范地址：https://npmcn.com/package/%40azure/cognitiveservices-customvision-training/

版本：5\.2\.0
npm 元数据更新时间：2026-04-03T21:09:42.595Z
中文译文更新时间：2026-11-07T21:56:08.852Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40azure/cognitiveservices-customvision-training
原文对照：https://npmcn.com/package/%40azure/cognitiveservices-customvision-training/?lang=original
项目主页：https://github.com/Azure/azure-sdk-for-js/tree/master/sdk/cognitiveservices/cognitiveservices-customvision-training
源码仓库：https://github.com/Azure/azure-sdk-for-js

弃用说明：This package has been deprecated\. For more information, please see: https://azure\.microsoft\.com/updates?id=502914

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：1.3 MB，34 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- 运行依赖：2 个
- 首次发布：2018-11-14T17:59:11.935Z
- 最新版本发布：2020-11-10T23:14:25.679Z
- 近 30 天下载量：2327（2026-10-08 至 2026-11-06，npm 官方下载统计）
- 已发布版本数：11（近 12 个月 0 个）

## 中文简介

TrainingAPIClient 库,有节点.js和浏览器的打字类型定义.

## 安装

```sh
npm install @azure/cognitiveservices-customvision-training
```

也可以使用：`pnpm add @azure/cognitiveservices-customvision-training`、`yarn add @azure/cognitiveservices-customvision-training`、`bun add @azure/cognitiveservices-customvision-training`

## README

## 用于培训的同位素 Javascript sdk

此套件包含用于培训APIClient的同位素 SDK.

### 目前得到支持的环境

-   节点.js 6.x.x 或更高版本
-   浏览器 JavaScript

### 如何安装

```bash
npm install @azure/cognitiveservices-customvision-training
```

### 如何使用

#### nodejs - 认证,客户端创建并获得Domains作为TypeScript所写的示例.

##### 样本代码

以下样本根据您的自定义视觉训练对图像进行快速测试 。 要了解更多的情况,请参考 [Azure 定制视觉服务文件](https://docs.microsoft.com/azure/cognitive-services/custom-vision-service/home)。 。 。 .

```javascript
const { TrainingAPIClient } = require("@azure/cognitiveservices-customvision-training");
const { ApiKeyCredentials } = require("@azure/ms-rest-js");

async function main() {
  const customVisionTrainingKey =
    process.env["customVisionTrainingKey"] || "<customVisionTrainingKey>";
  const customVisionTrainingEndPoint =
    process.env["customVisionTrainingEndPoint"] ||
    "<customVisionTrainingEndPoint>";
  const projectId = process.env["projectId"] || "<projectId>";
  const iterationId = process.env["iterationId"] || "<iterationId>";

  const credentials = new ApiKeyCredentials({ inHeader: { "Training-key": customVisionTrainingKey } });
  const client = new TrainingAPIClient(credentials, customVisionTrainingEndPoint);

  const imageURL =
    "https://www.atlantatrails.com/wp-content/uploads/2019/02/north-georgia-waterfalls-1024x683.jpg";

  const options = {
    iterationId: iterationId
  };

  client
    .quickTestImageUrl(
      projectId,
      {
        url: imageURL
      },
      options
    )
    .then(result => {
      console.log("The result is: ");
      console.log(result);
    })
    .catch(err => {
      console.log("An error occurred:");
      console.error(err);
    });
}

main();
```

#### 浏览器 - 认证,客户端创建并获得Domains作为JavaScript所写的例子.

##### 样本代码

-   索引.html

```html
<!DOCTYPE html>
<html lang="en">
  <head>
    <title>@azure/cognitiveservices-customvision-training sample</title>
    <script src="node_modules/@azure/ms-rest-js/dist/msRest.browser.js"></script>
    <script src="node_modules/@azure/cognitiveservices-customvision-training/dist/cognitiveservices-customvision-training.js"></script>
    <script type="text/javascript">
      const customVisionTrainingKey = "<YOUR_CUSTOM_VISION_TRAINING_KEY>";
      const customVisionTrainingEndPoint =
        "<YOUR_CUSTOM_VISION_TRAINING_ENDPOINT>";
      const projectId = "<YOUR_PROJECT_ID>";
      const iterationId = "<YOUR_ITERATION_ID>";
      const cognitiveServiceCredentials = new msRest.ApiKeyCredentials({
        inHeader: {
          "Ocp-Apim-Subscription-Key": customVisionTrainingKey
        }
      });

      const imageURL =
        "https://www.atlantatrails.com/wp-content/uploads/2019/02/north-georgia-waterfalls-1024x683.jpg";

      const client = new Azure.CognitiveservicesCustomvisionTraining.TrainingAPIClient(
        cognitiveServiceCredentials,
        customVisionTrainingEndPoint
      );

      const options = {
        iterationId: iterationId
      };

      client
        .quickTestImageUrl(
          projectId,
          {
            url: imageURL
          },
          options
        )
        .then(result => {
          console.log("The result is: ");
          console.log(result);
        })
        .catch(err => {
          console.log("An error occurred:");
          console.error(err);
        });
    </script>
  </head>
  <body></body>
</html>

```

## 相关项目

-   [Microsoft Azure SDK 用于 Javascript](https://github.com/Azure/azure-sdk-for-js)

![Impressions](https://azure-sdk-impressions.azurewebsites.net/api/impressions/azure-sdk-for-js%2Fsdk%2Fcognitiveservices%2Fcognitiveservices-customvision-training%2FREADME.png)

## 常见问题

### @azure/cognitiveservices-customvision-training 是什么？

TrainingAPIClient 库,有节点\.js和浏览器的打字类型定义\.注意：该包已被作者标记为弃用——This package has been deprecated\. For more information, please see: https://azure\.microsoft\.com/updates?id=502914

### 如何安装 @azure/cognitiveservices-customvision-training？

在项目目录运行 npm install @azure/cognitiveservices-customvision-training，或使用 pnpm add / yarn add / bun add。

### @azure/cognitiveservices-customvision-training 支持 TypeScript 吗？

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

### @azure/cognitiveservices-customvision-training 支持 ESM 还是 CommonJS？

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

### @azure/cognitiveservices-customvision-training 可以商用吗？

@azure/cognitiveservices-customvision-training 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @azure/cognitiveservices-customvision-training 的下载量有多少？

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

### @azure/cognitiveservices-customvision-training 还在维护吗？

最新版本 5\.2\.0 发布于 2020/11/11（5 年前）；至今共发布 11 个版本，其中过去 12 个月发布了 0 个；首次发布于 2018/11/15。作者已将其标记为弃用，新项目建议寻找替代方案。

