如何安装 @vercel/sdk？

可以使用 npm、pnpm、bun 或 yarn 安装。例如使用 npm：`npm add @vercel/sdk`；使用 pnpm：`pnpm add @vercel/sdk`。

如何在 CommonJS 项目中使用该 SDK？

该包仅作为 ES Module (ESM) 发布。在 CommonJS 应用中，需要使用 `await import("@vercel/sdk")` 来动态导入并使用。

如何进行身份验证？

SDK 全局支持 HTTP Bearer 认证。在初始化 Vercel 客户端实例时，将有效的 Access Token 赋值给 `bearerToken` 参数即可。

遇到 403 权限错误怎么办？

可能原因包括：Token 已过期；Token 没有正确的 scope（如团队或账户级别权限不匹配）；尝试使用的资源或操作在当前团队的计划中不可用（如 AccessGroups 仅限 Enterprise）。

这个 SDK 是由谁构建的？

根据仓库说明，该 SDK 由 Speakeasy 构建。

2026年9月28日

@vercel/sdk

开发与工程 API 与集成3

查看仓库

类型安全的 TypeScript SDK，用于通过 Vercel REST API 控制整个 Vercel 平台。

Apache-2.0

Web RESTful

安装命令（说明）bash

npm add @vercel/sdk

最小示例代码python

import { Vercel } from "@vercel/sdk";

const vercel = new Vercel({
  bearerToken: "<YOUR_BEARER_TOKEN_HERE>",
});

async function run() {
  const result = await vercel.replaceDomainsByDomainRecords({
    domain: "example.com",
  });

  console.log(result);
}

run();

产品信息

形态: API / SDK / 库
分类: 开发与工程 › API 与集成
定价: 开源
授权协议: Apache-2.0
首发日期: 2026年9月28日
收录时间: 2026年9月28日
官网: github.com

概览

GitHub GitHub

`@vercel/sdk` 是一个类型安全的 TypeScript SDK，为开发者提供对 Vercel REST API 的完整访问能力。它由 Speakeasy 构建，采用 Apache-2.0 协议开源。 ## 主要能力该 SDK 覆盖了 Vercel 平台的多种资源与操作，包括但不限于： - **项目管理**：通过名称或 ID 更新现有项目的字段配置。 - **域名管理**：替换域名记录、获取域名记录等。 - **Access Groups**：创建、读取、更新、删除访问组及其关联的项目和成员（Enterprise 功能）。 - **AI Gateway**：管理 AI Gateway 规则。 - **Aliases**：列出、分配、获取和删除部署别名。 - **API Keys**：创建 API 密钥。 - **Observability**：创建可观测性查询、获取指标 Schema。 - **Insights**：切换 Speed Insights 和 Web Insights 的状态。 ## 技术特性 - **认证方式**：全局支持 HTTP Bearer Token 认证，初始化客户端时传入 `bearerToken` 即可。 - **模块化设计**：支持 Standalone functions，可按需调用独立函数。 - **其他能力**：内置文件上传、自动重试、错误处理、服务器选择、自定义 HTTP 客户端以及调试支持。 - **包格式**：仅作为 ES Module (ESM) 发布。CommonJS 应用需使用 `await import("@vercel/sdk")` 动态导入。 ## 适用人群适合需要通过代码自动化管理 Vercel 部署、项目、域名及团队权限的 TypeScript/JavaScript 开发者。使用前需在 Vercel Dashboard 创建具有正确 scope 的 Access Token。

功能特性

类型安全：基于 TypeScript 构建，提供完整的类型提示与检查。
Bearer Token 认证：初始化客户端时传入 bearerToken 即可完成 API 鉴权。
项目管理：支持通过项目名称或 ID 更新项目配置字段。
域名操作：提供替换域名记录、按记录 ID 获取域名记录等方法。
Access Groups 管理：支持访问组及其成员、关联项目的增删改查操作。
AI Gateway 规则：支持创建、列出、更新和删除 AI Gateway 规则。
部署别名管理：支持列出、分配、获取和删除部署别名。
可观测性查询：支持创建 Observability 查询并获取相关 Schema。
Insights 状态切换：支持开启或关闭 Speed Insights 和 Web Insights。
自动重试与错误处理：内置请求重试机制与结构化的错误处理能力。
自定义 HTTP Client：允许开发者传入自定义的 HTTP 客户端实例。
仅 ESM 发布：包以 ES Module 格式发布，CommonJS 环境需动态导入。

版本更新

新版本提醒我

首个版本 · @vercel/sdk

2026年9月28日

Q&A

如何安装 @vercel/sdk？由 AI 生成: 可以使用 npm、pnpm、bun 或 yarn 安装。例如使用 npm：`npm add @vercel/sdk`；使用 pnpm：`pnpm add @vercel/sdk`。
如何在 CommonJS 项目中使用该 SDK？由 AI 生成: 该包仅作为 ES Module (ESM) 发布。在 CommonJS 应用中，需要使用 `await import("@vercel/sdk")` 来动态导入并使用。
如何进行身份验证？由 AI 生成: SDK 全局支持 HTTP Bearer 认证。在初始化 Vercel 客户端实例时，将有效的 Access Token 赋值给 `bearerToken` 参数即可。
遇到 403 权限错误怎么办？由 AI 生成: 可能原因包括：Token 已过期；Token 没有正确的 scope（如团队或账户级别权限不匹配）；尝试使用的资源或操作在当前团队的计划中不可用（如 AccessGroups 仅限 Enterprise）。
这个 SDK 是由谁构建的？由 AI 生成: 根据仓库说明，该 SDK 由 Speakeasy 构建。

查看仓库

这个产品还没有主理人

一个基于 Docker 的开源 API 平台，提供生活、出行、开发工具等多场景接口。

发布于 3周前2

开源免费