歌者 Open API

创建内容提取任务

POST

https://api.gezhe.com/v1/extracts

该接口可以将 PPT 文件中的文本提取出来，返回文本的内容、位置坐标、大小等信息。

注：由于PPT 是矢量渲染，适配各种尺寸屏幕播放，长度单位并不是像素。
PPT 中获取到的宽度、高度、距离等数字，单位为 PPT 内置单位，一厘米等于 360,000。如需转换为厘米，可将接口获取的值除以 360,000

请求参数

Authorization

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

Authorization: Bearer ********************

Body 参数multipart/form-data

file

可选

需要提取内容的文件，支持 pptx 格式，最大 30M，file 和 fileURL二者选一

fileURL

string

可选

要提取的文件 URL，支持 pptx 格式文件要在300M之内，file 和 fileURL二者选一

output

enum<string>

必需

输出格式，当前暂只支持 text

枚举值:

text

默认值:

text

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://api.gezhe.com/v1/extracts' \
--form 'file=@""' \
--form 'fileURL=""' \
--form 'output=""'

返回响应

🟢200成功

application/json

Body

string

任务 ID

必需

任务唯一标识

示例

{
  "id": "string"
}

获取下载地址

查询任务详情