新建转换任务 - 歌者 Open API

请求参数

Body 参数multipart/form-data

file

可选

直接上传文件，需小于 30M，（file/fileURL 必须二选一，不能同时为空，也不能同时有值)，支持 doc、docx、ppt、pptx 格式文件

fileURL

string

可选

文件访问 URL，需小于 100M，（file/fileURL 必须二选一，不能同时为空，也不能同时有值)，支持 doc、docx、ppt、pptx 格式文件

type

enum<string>

必需

ppt2pdf 或 doc2pdf，传 ppt2pdf 时，传入的文件需要为 ppt 或 pptx 格式，传 doc2pdf 时，传入的文件需要为 doc 或 docx 格式

枚举值:

ppt2pdfdoc2pdf

示例值:

转换类型

notifyURL

string

可选

合法的 url 地址，返回状态 200 即为收到通知

示例值:

接受任务状态变更的回调地址

isSync

boolean

可选

true 或 false，如果是同步调用，直接返回结果，否则是异步，需要再调用查询接口获取状态

默认值:

false

示例值:

是否同步调用

示例代码

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

curl --location --request POST 'https://api.gezhe.com/v1/converts' \
--form 'file=@""' \
--form 'fileURL=""' \
--form 'type="转换类型"' \
--form 'notifyURL="接受任务状态变更的回调地址"' \
--form 'isSync="是否同步调用"'

返回响应

🟢200成功

application/json

Body

id

string

任务 ID

必需

示例

{
  "id": "string"
}