Java SDK 下载

视频翻译 Java SDK 简介：依赖环境、Maven 获取安装方式与快速调用示例

欢迎使用视频字幕翻译服务 Java SDK（translate-sdk）。SDK提供项目管理、视频上传、翻译处理、字幕编辑、成品下载等全部接口的 Java 调用能力，帮助您在 Java 应用中快速集成视频翻译服务。

依赖环境

JDK 1.8 及以上版本。
Maven 3.x 或其他支持 Maven 中央仓库的构建工具。

获取安装

使用 SDK 需要访问秘钥（appId / appSecret），可前往 个人中心 - 访问秘钥 页面创建。

密钥须严格保管，避免泄露。appSecret 仅用于服务端请求签名，绝不能硬编码在代码中或下发到前端，建议保存在配置文件或环境变量里。

通过 Maven 安装（推荐）

在项目 pom.xml 中添加依赖：

<dependency>
    <groupId>net.translatebase</groupId>
    <artifactId>translate-sdk</artifactId>
    <version>1.0.0</version>
</dependency>

所有历史版本可在 Maven 中央仓库查询。

SDK 已内置请求框架，无需额外引入其他依赖；如需后端直传模式上传视频，请自行引入腾讯云 COS Java SDK（cos_api）。

示例

以查询项目列表为例：

import com.jiyou.base.api.sdk.BaseApiClient;
import com.jiyou.base.sdk.request.ProjectListRequest;
import com.jiyou.base.sdk.response.ProjectListResponse;

public class ProjectListDemo {
    public static void main(String[] args) {
        // 服务地址为平台提供的 API 地址；appId / appSecret 为访问秘钥
        BaseApiClient client = new BaseApiClient(
                "https://www.translatebase.net/TranslateService", "yourAppId", "yourAppSecret");

        // page 从 1 开始；dataEqual/dataLike/dataRange 为过滤条件 JSON 串，无需过滤时传 null
        ProjectListRequest request = new ProjectListRequest(1, 10, null, null, null, null, null);
        ProjectListResponse response = client.execute(request, ProjectListResponse.class);

        if (response.isSuccess()) {
            System.out.println("项目总数：" + response.getData().getTotal());
            System.out.println("当前页项目：" + response.getData().getRecords());
        } else {
            System.out.println("调用失败：" + response.getMsg());
        }
    }
}

通用调用模式

所有接口遵循统一模式：一个接口对应一个 Request 和一个 Response。

// 1. 构造请求（构造参数即接口参数）
XxxRequest request = new XxxRequest(...);
// 2. 执行请求（第二个参数为对应的 Response 类型）
XxxResponse response = client.execute(request, XxxResponse.class);
// 3. 判断结果、取数据
if (response.isSuccess()) {
    Object data = response.getData();
}

客户端实例线程安全，建议创建一次全局复用。SDK 不做客户端参数校验，必填参数缺失时由服务端返回明确错误信息。

各方法的详细使用说明见 Java SDK 使用教程；直接调用 HTTP API 的参数说明见视频翻译 API 概述。