歌者 Open API
开发文档歌者首页
开发文档歌者首页
  1. 演示文稿翻译
  • 接入指引
  • 账号授权
  • 错误码说明
  • 演示文稿渲染
    • 费用说明
    • 创建渲染任务
      POST
    • 查询任务详情
      GET
    • 删除一个任务
      DELETE
  • 演示文稿翻译
    • 翻译流程说明
    • 费用说明
    • 创建翻译任务
      POST
    • 查询翻译任务
      GET
    • 删除翻译任务
      DELETE
    • 获取翻译对比
      GET
    • 提交修改后翻译的内容
      PUT
    • 获取下载地址
      GET
  • 演示文稿内容提取
    • 费用说明
    • 创建内容提取任务
      POST
    • 查询任务详情
      GET
    • 删除一个任务
      DELETE
  • 智能生成 PPT
    • 费用说明
    • 格式说明
    • 创建无损排版任务
      POST
    • 查询无损排版任务
      GET
    • 模板列表
      GET
  • 格式转换
    • 费用说明
    • 新建转换任务
      POST
    • 查询转换任务
      GET
  • PPT 导出为可播放的 HTML
    • 费用说明
    • 创建导出任务
    • 查询导出任务
  • 演示文稿压缩
    • 费用说明
    • 新建压缩任务
    • 查看压缩任务
  • 演示文稿防盗指纹
    • 费用说明
    • 添加防盗指纹
    • 校验防盗指纹
  • 演示文稿切分和合并
    • 演示文稿切分
    • 演示文稿合并
  • 彩漩阅读数据
    • 文档阅读者列表
    • 阅读列表
  1. 演示文稿翻译

创建翻译任务

POST
https://api.gezhe.com/v1/translations
创建一个翻译任务,支持 pptx 格式,文件保留源格式的翻译,此任务为异步,获取结果需要调用查询任务详情接口获取。

请求参数

Authorization
在 Header 添加参数
Authorization
,其值为在 Bearer 之后拼接 Token
示例:
Authorization: Bearer ********************
Body 参数multipart/form-data
file
file 
可选
要翻译的文件,支持 pptx 格式文件,单个文件最多 300 页、最多 30 万个字符,要在30M之内,file 和 fileURL二者选一
fileURL
string 
可选
要翻译的文件 URL,支持 pptx 格式文件,单个文件最多 300 页、最多 30 万个字符,要在300M之内,file 和 fileURL二者选一
name
string 
可选
任务名称,不填时会使用文件名
from
enum<string> 
可选
可选,不填时为自动识别
枚举值:
autoarbgcsdadeelenesetfifrhuiditjakoltlvnbnlplptroruskslsvtrukzh
to
enum<string> 
必需
枚举值:
arbgcsdadeelenen-gben-usesetfifrhuiditjakoltlvnbnlplptpt-brpt-ptroruskslsvtrukzh-hanszh-hant
useGlossaryId
string 
可选
使用术语表,预留,暂不支持
thumbnailRequired
boolean 
可选
是否需要翻译前后的截图,默认为 false
默认值:
false
imageTranslate
boolean 
可选
是否需要翻译图片,默认为 false
默认值:
false
byStep
boolean 
可选
系统翻译后,需要再调整翻译结果时,可配置为 true
默认值:
false
notifyURL
string 
可选
接受任务状态变更的回调地址

示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://api.gezhe.com/v1/translations' \
--form 'file=@""' \
--form 'fileURL=""' \
--form 'name=""' \
--form 'from=""' \
--form 'to=""' \
--form 'useGlossaryId=""' \
--form 'thumbnailRequired=""' \
--form 'imageTranslate=""' \
--form 'byStep=""' \
--form 'notifyURL=""'

返回响应

🟢200成功
application/json
Body
id
string 
任务 ID
必需
errorCode
string 
错误码
可选
详情见:https://open.gezhe.com/doc-5209548
errorMsg
string 
错误信息
可选
示例
{
  "id": "string",
  "errorCode": "string",
  "errorMsg": "string"
}
上一页
费用说明
下一页
查询翻译任务
Built with