短剧智能翻译提供了多种主流语言的 SDK，您可以基于 SDK 编写代码来调用 OpenAPI，让您不用复杂编程即可快捷访问短剧智能翻译服务。 ## SDK 优势 * 封装了 OpenAPI 的调用和响应，避免需要繁琐计算 API 签名。 * 封装了短剧智能翻译常用 OpenAPI，并提供了对应的示例代码。 * 封装了常用的操作流程，比如服务端生成临时安全凭证。 * 支持 Java、Python、PHP、Go 四种开发语言。 ## 前提条件开始使用 SDK 前，您需要完成以下准备工作。 * 开通[智能翻译平台](https://console.volcengine.com/translate/starling-i18n/video_translate/) * 获取 AK 和 SK：您需要提前准备好调 OpenAPI 的 AK 和 SK（即密钥）。 [获取密钥](https://www.volcengine.com/docs/4640/127684) ## SDK 源码地址和集成列表 |编程语言 |源码地址 |使用文档 | |---|---|---| |PHP |[volcengine-php-sdk](https://github.com/volcengine/volcengine-php-sdk/tree/main/src/I18nopenapi) |* [集成 SDK](https://packagist.org/packages/volcengine/volcengine-php-sdk) | |Python |[volcengine-python-sdk](https://github.com/volcengine/volcengine-python-sdk/tree/master/volcenginesdki18nopenapi) |* [集成 SDK](https://pypi.org/project/volcengine-python-sdk/) | |Go |[volcengine-go-sdk](https://github.com/volcengine/volcengine-go-sdk/tree/master/service/i18nopenapi) |* [集成 SDK](https://github.com/volcengine/volcengine-go-sdk/blob/master/README.MD) | |Java |[volcengine-java-sdk](https://github.com/volcengine/volcengine-java-sdk/tree/master/volcengine-java-sdk-i18nopenapi) |* [集成 SDK](https://central.sonatype.com/artifact/com.volcengine/volcengine-java-sdk-i18nopenapi) | |Node.js |

||\ | |暂不支持

| |\ | | | | ## 接口调用示例本节以 [VideoProjectCreate - 创建视频翻译项目](https://www.volcengine.com/docs/4640/2120614) 接口为例，展示使用 VOD SDK 时如何调用短剧智能翻译接口 ### PHP ```TypeScript setAk("xx") // 替换为你的 Access Key ->setSk("xx") // 替换为你的 Secret Key ->setRegion("cn-beijing"); $body = new \Volcengine\I18nopenapi\Model\VideoProjectCreateRequest(); $body-> setName("项目名"); $body-> setProjectType(1); try { print_r($body); $result = $apiInstance->VideoProjectCreate($body); // if ($result->getProjectId()) { // echo "创建成功，项目 ID: " . $result->getProjectId(); // echo "项目名称: " . $result->getProjectName(); // } else { // echo "项目创建失败，返回的 project_id 为 null"; // } print_r('---->'); print_r($result); } catch (Exception $e) { echo 'Exception when calling I18NOPENAPIApi->createVideoProjectSerialTask: ', $e->getMessage(), PHP_EOL; } ?> ``` ### Python ```TypeScript # -*- coding: utf-8 -*- from __future__ import print_function import volcenginesdkcore import volcenginesdki18nopenapi from volcenginesdki18nopenapi.models import ( VideoProjectSerialDubTaskCreateRequest, TaskInfoForVideoProjectSerialDubTaskCreateInput, SerialInfoForVideoProjectSerialDubTaskCreateInput, VideoForVideoProjectSerialDubTaskCreateInput, SubtitleForVideoProjectSerialDubTaskCreateInput, ) from volcenginesdkcore.rest import ApiException def test_main(): """ 主函数，演示如何调用 i18n_openapi 服务的 video_project_serial_dub_task_create 接口 """ configuration = volcenginesdkcore.Configuration() configuration.ak = "******" configuration.sk = "******==" configuration.region = "cn-beijing" configuration.client_side_validation = True configuration.debug = True # 设置为全局默认配置 volcenginesdkcore.Configuration.set_default(configuration) # 使用全局默认配置创建 API 实例 api_instance = volcenginesdki18nopenapi.I18NOPENAPIApi() # 根据提供的 JSON 构造请求入参 task_info = TaskInfoForVideoProjectSerialDubTaskCreateInput( task_name="task_name", serial_number=1, source_lang="zh", target_langs=["en", "th"], is_dub=True, bgm_policy=0, ai_remove_type=0, ) serial_info = [ SerialInfoForVideoProjectSerialDubTaskCreateInput( episode=1, video=VideoForVideoProjectSerialDubTaskCreateInput( vid="vzzzzz", name="name.mp4", ), subtitles=[ SubtitleForVideoProjectSerialDubTaskCreateInput( uri="xxxx.srt", name="name.srt", file_type=1, subtitle_lang=2, target_lang="en", ), SubtitleForVideoProjectSerialDubTaskCreateInput( uri="xxx.srt", name="name.srt", file_type=1, subtitle_lang=2, target_lang="th", ), ], ) ] request = VideoProjectSerialDubTaskCreateRequest( project_id=123456, task_info=task_info, serial_info=serial_info, ) try: resp = api_instance.video_project_serial_dub_task_create(body=request) print(resp) except ApiException as e: print("调用 I18NOPENAPIApi->video_project_serial_dub_task_create 时发生异常: %s\n" % e) if __name__ == '__main__': test_main() ``` ## Go ```Go package main import ( "fmt" "github.com/volcengine/volcengine-go-sdk/service/i18nopenapi" "github.com/volcengine/volcengine-go-sdk/volcengine" "github.com/volcengine/volcengine-go-sdk/volcengine/credentials" "github.com/volcengine/volcengine-go-sdk/volcengine/session" ) func main() { // 请替换为您的 AK、SK 和 Region ak, sk, region := "your ak", "your sk", "cn-beijing" // 初始化配置 config := volcengine.NewConfig(). WithRegion(region). WithCredentials(credentials.NewStaticCredentials(ak, sk, "")) // 创建会话 sess, err := session.NewSession(config) if err != nil { panic(fmt.Sprintf("Failed to create session: %v", err)) } // 创建 i18nopenapi 客户端 svc := i18nopenapi.New(sess) // 使用 VideoProjectCreate 获取响应（现在直接返回 map 格式的原始响应） fmt.Println("=== Using VideoProjectCreate ===") videoProjectCreateInput := &i18nopenapi.VideoProjectCreateInput{ Name: volcengine.String("my-video-project-2"), ProjectType: volcengine.Int32(1), Comment: volcengine.String("这是第二个示例视频项目"), } resp, err := svc.VideoProjectCreate(videoProjectCreateInput) if err != nil { fmt.Printf("Error: %v\n", err) } else { fmt.Printf("Response: %s\n", resp.String()) // 直接访问 map 中的数据 if resp.Response != nil { if data, ok := resp.Response["data"].(map[string]interface{}); ok { if projectId, ok := data["projectId"].(string); ok { fmt.Printf("Project ID: %s\n", projectId) } if projectName, ok := data["projectName"].(string); ok { fmt.Printf("Project Name: %s\n", projectName) } } } } } ``` ## Java 敬请期待

机器翻译