智能媒资托管 快速入门（Java SDK）

一、相关资源

·Java SDK 源码：源码快速下载

·产品文档：SMH 产品文档

·控制台：SMH 控制台

二、环境配置与准备

·运行环境需 JDK 11 及以上版本。

·登录 智能媒资托管控制台，开通 SMH 服务并创建媒体库。获取媒体库 ID（libraryId）和专属域名。

三、初始化 SMH 服务

注意：调用方式建议：推荐使用 xxxWithHttpInfo 方法

注意：SDK 的每个 REST 接口都会同时生成两种调用方式：

四、引入 SDK

import com.tencent.cloud.smh.SmhClient;import com.tencent.cloud.smh.ApiException;import com.tencent.cloud.smh.api.TokenApi;import com.tencent.cloud.smh.api.FileApi;import com.tencent.cloud.smh.model.*;import java.math.BigDecimal;

五、初始化 SmhClient

// 创建 SMH 客户端，设置专属域名（必须）SmhClient client = new SmhClient("https://smhxxx.api.tencentsmh.cn");

注意：说明：

注意：SmhClient 不会自动注入 libraryId、spaceId、accessToken 的默认值，每次调用 API 都需要显式传入 libraryId 和 spaceId。访问令牌有两种使用方式：调用 client.withToken(accessToken) 后由 SDK 自动携带 Authorization: Bearer 头（推荐）；或在每次调用时通过 accessToken 参数单独传入。

六、生成访问令牌

// 生成访问令牌SmhClient client = new SmhClient("https://smhxxx.api.tencentsmh.cn");try { // 构建创建令牌请求 TokenApi.APICreateTokenRequest request = TokenApi.APICreateTokenRequest.newBuilder() .libraryId("your-library-id") // 媒体库 ID，在媒体托管控制台创建媒体库后获取 .librarySecret("your-library-secret") // 媒体库密钥，在媒体托管控制台创建媒体库后获取 .spaceId("your-space-id") // 空间 ID（可选） .userId("user-id") // 用户身份识别（可选） .build(); // 获取访问令牌（WithHttpInfo 返回 ApiResponse<Object>，需强转） CreateToken200Response tokenResp = (CreateToken200Response) client.token() .createTokenWithHttpInfo(request).getData(); String accessToken = tokenResp.getAccessToken(); System.out.println("Access Token: " + accessToken); System.out.println("Expires In: " + tokenResp.getExpiresIn() + " seconds"); // 将令牌注入客户端，后续调用自动携带 Authorization: Bearer 头 client.withToken(accessToken);} catch (ApiException e) { System.err.println("获取令牌失败: " + e.getCode() + " – " + e.getMessage());}

请求参数

以下是 Grant 参数支持的权限项：

七、Access Token 续期

Token 有效期（默认 24 小时），过期后需要重新获取。建议在业务代码中实现 Token 续期逻辑：

// 构建续期令牌请求TokenApi.APIRenewTokenRequest request = TokenApi.APIRenewTokenRequest.newBuilder() .libraryId("your-library-id") .accessToken("your-access-token") // 待续期的访问令牌 .build();try { CreateToken200Response resp = (CreateToken200Response) client.token() .renewTokenWithHttpInfo(request).getData(); if (resp != null && resp.getAccessToken() != null) { System.out.println("Token renewed: " + resp.getAccessToken()); System.out.println("Expires in: " + resp.getExpiresIn() + " seconds"); // 将新 Token 设置到客户端中继续使用 client.withToken(resp.getAccessToken()); }} catch (ApiException e) { System.err.println("续期失败: " + e.getCode() + " – " + e.getMessage());}

注意：建议在业务逻辑中提前进行续期以避免请求失败。

八、删除访问令牌

令牌不再需要时可主动删除使其立即失效：

// 删除指定访问令牌（立即失效）TokenApi.APIDeleteTokenRequest delRequest = TokenApi.APIDeleteTokenRequest.newBuilder() .libraryId("your-library-id") .accessToken("your-access-token") .build();client.token().deleteTokenWithHttpInfo(delRequest);// 删除特定用户的全部访问令牌（需要媒体库密钥，可选 clientId/sessionId 进一步限定范围）TokenApi.APIDeleteUserTokensRequest delUserRequest = TokenApi.APIDeleteUserTokensRequest.newBuilder() .libraryId("your-library-id") .librarySecret("your-library-secret") .userId("user-id") .build();client.token().deleteUserTokensWithHttpInfo(delUserRequest);

两个接口成功均返回 HTTP 204，无响应体。

九、使用 API

完成初始化和令牌获取后，即可调用各种 API 进行文件操作：

try { // 构建获取文件信息请求（info 为固定标识参数，传 1 即可） FileApi.APIInfoFileRequest infoRequest = FileApi.APIInfoFileRequest.newBuilder() .libraryId("your-library-id") .spaceId("your-space-id") .filePath("/path/to/file.txt") .info(BigDecimal.ONE) .build(); // WithHttpInfo 返回 ApiResponse<Object>，getData() 需强转为对应响应类型 InfoFile200Response response = (InfoFile200Response) client.file() .infoFileWithHttpInfo(infoRequest).getData(); System.out.println("媒体类型: " + response.getContentType()); System.out.println("文件大小: " + response.getSize());} catch (ApiException e) { System.err.println("API 错误: " + e.getCode() + " – " + e.getMessage());}