You need to enable JavaScript to run this app.
机器翻译

机器翻译

请输入
  • 文档首页
    • 机器翻译国际化翻译平台短剧智能翻译API 参考调用方式
复制全文
我的收藏
API 参考
调用方式
复制全文
我的收藏
调用方式

本文为您介绍在使用短剧智能翻译 API 时必须了解的一些信息。

前提条件

  • 开始使用 SDK 前，您需要完成以下准备工作。
    开通智能翻译平台
  • 获取 AK 和 SK：您需要提前准备好调 OpenAPI 的 AK 和 SK（即密钥）。 获取密钥

请求结构

服务地址

接入地址

open.volcengineapi.com

通信协议

支持通过 HTTP 和 HTTPS 两种方式进行请求通信，推荐使用安全性更高的 HTTPS 方式发送请求。

请求方法

根据各个接口的具体需求，选择 GET 或 POST 方式发起请求。

方法

说明

GET（推荐）

请求服务器返回指定资源。

  • 使用 GET 方式，所有参数均放在 Query String 中的。
  • 使用 GET 方式，所有请求参数均需要做 URL 编码。

POST

请求服务器新增资源或执行特殊操作。

  • 使用 POST 方式，所有参数放在 Request Body 中。
  • 使用 POST 方式，POST 方式无需对参数编码。

注意

  • 公共参数中的 Action 和 Version 必须放在 Query String 中。

请求参数

在发起请求时，需要包含以下两类参数：

  • 公共请求参数：公共请求参数是用于标识账号和接口签名的参数，所有接口都相同。每次请求都需要携带这些参数才能正常发起请求。具体参数介绍请见公共参数。
  • 接口请求参数：接口特有的请求参数请参看具体接口文档。

字符编码

请求及返回结果都使用 UTF-8 字符集进行编码。

签名机制

详细的签名机制和签名示例，请参见签名方法。
签名生成示例（签名生成逻辑复杂，建议直接使用示例中的签名示例）

sign_example.js
10.41KB

返回结果

HTTP 状态码

响应 HTTP 状态码成功请求的情况下均为 200，部分失败请求会返回 4xx 及 5xx 的错误码。

公共返回参数

公共返回参数如下表所示。

ResponseMetadata

参数

类型

描述

RequestId

String

请求 ID

Action

String

请求接口

Version

String

版本

Service

String

服务

Region

String

区域

Error

ResponseError

异常信息

ResponseError

参数

类型

描述

Code

String

错误码

Message

String

详细错误信息

说明

您可以通过返回结果中 ResponseMetadata 结构体是否存在 Error 字段来判断返回结果是否正常。存在 Error 字段则表示返回结果异常。

返回结果示例

正常返回结果

{
    "ResponseMetadata": {
        "RequestId": "201806041104200100100232280022D30",
        "Action": "",
        "Version": "2021-05-21",
        "Service": "",
        "Region": "cn-north-1"
        }，
    "Result": {
       ......
    }
}

异常返回结果

{
    "ResponseMetadata": {
        "RequestId": "201806041104200100100232280022D30",
        "Action": "",
        "Version": "2021-05-21",
        "Service": "",
        "Region": "cn-north-1",
        "Error": {
            "Code": "ResourceNotFound",
            "Message": "resource is not found"
      }
   }
}
最近更新时间：2026.02.03 16:09:19
这个页面对您有帮助吗？
有用
有用
无用
无用