火山引擎API怎么用C#接入？

用 C# 对接火山引擎 API，核心其实就三件事：先完成身份认证，再把签名构造好，最后发起 HTTP 请求。更省事的做法，是直接使用最新的 .NET SDK，让签名这部分自动处理；如果选择手动调用，就必须严格按照规范拼接待签名字符串，使用 HMAC-SHA256 生成经过 Base64 编码的 Signature，同时把 Authorization 头和 GMT 时间戳准确设置到位。

要在C#项目中调用火山引擎API（如VES、ECS、VOD等服务），必须先完成身份认证、构造签名、发起HTTP请求三个核心环节，缺一不可。

安装SDK或手动封装HTTP客户端

方法一：使用最新.NET SDK（推荐）
在NuGet包管理器中执行：Install-Package VolcEngine.SDK.Core 和对应服务的SDK，例如 VolcEngine.SDK.Vod。这一步省去签名逻辑，SDK自动处理AK/SK校验与时间戳生成。

方法二：纯HttpClient手动调用（适合调试或轻量集成）
新建 HttpClient 实例，设置默认请求头 Content-Type: application/json 和 X-Date 时间戳（格式为 EEE, dd MMM yyyy HH:mm:ss GMT），注意时区必须为GMT，本地时间直接转换会出错。

配置访问密钥与区域信息

从火山引擎控制台「访问密钥」页面获取

服务Endpoint取决于所选地域，例如华东1（上海）的VOD服务地址是 https://vod.cn-east-1.volcapi.com，不同产品、不同Region的域名不互通，填错会导致403或连接拒绝。

构造并发送带签名的请求

第一步：拼接待签名字符串
按规范组合 HTTPMethod + n + CanonicalURI + n + CanonicalQueryString + n + CanonicalHeaders + n + SignedHeaders + n + HexEncode(Hash(Payload))，其中 CanonicalURI 必须以 / 开头且不带查询参数，漏掉斜杠将导致签名失败。

第二步：生成Signature
用HMAC-SHA256算法，以 SK 为密钥，对上一步字符串进行哈希，再Base64编码。C#中调用 HMACSHA256.ComputeHash() 后必须用 Convert.ToBase64String() 转换，直接ToString()会输出类型名而非实际值。

第三步：组装Authorization头
格式为 HMAC-SHA256 Credential=AK/Date/Region/Service/RequestType, SignedHeaders=host;x-date, Signature=xxx，其中 Region（如 cn-east-1）、Service（如 vod）必须与Endpoint中一致，大小写敏感。

第四步：发起POST请求
将JSON Body序列化后写入 StringContent，设置 ContentType 为 application/json，调用 client.PostAsync(endpoint, content)。若返回401，大概率是签名时间偏移超过5分钟，检查服务器时间是否同步NTP。