智能文档摘要用于快速识别长篇文档中的核心要点、关键句子或段落,自动生成文档内容的简短概括或提取关键信息,帮助您高效地了解文档主旨,节省阅读和理解全文所需的时间。
前提条件
已绑定IMM Project。通过OSS控制台绑定的具体操作,请参见快速入门。通过API绑定的具体操作,请参见AttachOSSBucket。
注意事项
智能文档摘要功能仅支持同步处理(x-oss-process处理方式)。
该接口需采用POST方式请求。
不支持匿名访问。
必须拥有IMM处理所需的相关权限。更多信息,请参见权限。
参数说明
操作名称:doc/summarize
具体参数如下表所示。
参数 | 类型 | 是否必须 | 描述 |
content | string | 是 | 需要摘要的文档内容,需经过URL安全的Base64编码。 说明 最大支持长度为19500字节。 |
format | string | 否 | 指定返回数据的方式,取值:
|
返回参数如下表所示:
参数 | 类型 | 描述 |
RequestId | string | 当次请求的Request ID。 |
Output | struct | 输出的结果内容。 子节点:Text, FinishReason |
Text | string | 本次请求的处理得到的结果内容。 父节点:Output |
FinishReason | string | 表明当前生成结果的现状。取值:
父节点:Output |
使用REST API
使用REST AP进行文档智能摘要时需要指定文件名称,但文件名称仅作为占位符使用。使用智能文档摘要时,只识别content参数作为需要提取摘要的文档内容。
使用普通模式进行文档智能摘要
处理方式
待处理文件:example.doc
待摘要文本:“四大名著,被誉为中国文学宝库中的璀璨明珠,是中国古代小说艺术巅峰的象征。这四部举世闻名的小说巨著,分别是罗贯中所创作的历史题材小说《三国演义》,吴承恩笔下的神魔奇幻作品《西游记》,施耐庵创作的英雄传奇小说《水浒传》,以及曹雪芹撰写的人情世故与家族兴衰的经典之作《红楼梦》。《三国演义》以东汉末年及三国时代为背景,生动描绘了群雄争霸的历史画卷;《西游记》则以唐僧师徒取经的故事为主线,融合了大量的神话传说和民间故事,展现出一幅瑰丽奇特的神魔世界;《水浒传》讲述了北宋末年梁山好汉们反抗封建统治者的壮丽史诗,展现了草莽英雄们的豪迈气概;而《红楼梦》则是通过对贾宝玉及其周围人物命运的深入剖析,反映了封建社会末期大家族的荣枯兴衰和社会现实的深刻揭示。这四大名著,各具特色,各有千秋,不仅在中国文学史上留下了浓墨重彩的一笔,更在世界文学领域内产生了深远影响,成为了中华文化不可或缺的重要组成部分。”
返回结果方式:json
处理示例
POST /example.doc?x-oss-process HTTP/1.1
Host: doc-demo.oss-cn-hangzhou.aliyuncs.com
Date: Fri, 28 Oct 2022 06:40:10 GMT
Authorization: OSS qn6q**************:77Dv****************
x-oss-process=doc/summarize,content__5Zub5aSn5ZCN6JGX77yM6KKr6KqJ5Li65Lit5Zu95paH5a2m5a6d5bqT5Lit55qE55KA55Ko5piO54-g77yM5piv5Lit5Zu95Y-k5Luj5bCP6K-06Im65pyv5beF5bOw55qE6LGh5b6B44CC6L-Z5Zub6YOo5Li-5LiW6Ze75ZCN55qE5bCP6K-05beo6JGX77yM5YiG5Yir5piv572X6LSv5Lit5omA5Yib5L2c55qE5Y6G5Y-y6aKY5p2Q5bCP6K-044CK5LiJ5Zu95ryU5LmJ44CL77yM5ZC05om_5oGp56yU5LiL55qE56We6a2U5aWH5bm75L2c5ZOB44CK6KW_5ri46K6w44CL77yM5pa96ICQ5bq15Yib5L2c55qE6Iux6ZuE5Lyg5aWH5bCP6K-044CK5rC05rWS5Lyg44CL77yM5Lul5Y-K5pu56Zuq6Iq55pKw5YaZ55qE5Lq65oOF5LiW5pWF5LiO5a625peP5YW06KGw55qE57uP5YW45LmL5L2c44CK57qi5qW85qKm44CL44CC44CK5LiJ5Zu95ryU5LmJ44CL5Lul5Lic5rGJ5pyr5bm05Y-K5LiJ5Zu95pe25Luj5Li66IOM5pmv77yM55Sf5Yqo5o-P57uY5LqG576k6ZuE5LqJ6Zy455qE5Y6G5Y-y55S75Y2377yb44CK6KW_5ri46K6w44CL5YiZ5Lul5ZSQ5YOn5biI5b6S5Y-W57uP55qE5pWF5LqL5Li65Li757q_77yM6J6N5ZCI5LqG5aSn6YeP55qE56We6K-d5Lyg6K-05ZKM5rCR6Ze05pWF5LqL77yM5bGV546w5Ye65LiA5bmF55Gw5Li95aWH54m555qE56We6a2U5LiW55WM77yb44CK5rC05rWS5Lyg44CL6K6y6L-w5LqG5YyX5a6L5pyr5bm05qKB5bGx5aW95rGJ5Lus5Y-N5oqX5bCB5bu657uf5rK76ICF55qE5aOu5Li95Y-y6K-X77yM5bGV546w5LqG6I2J6I696Iux6ZuE5Lus55qE6LGq6L-I5rCU5qaC77yb6ICM44CK57qi5qW85qKm44CL5YiZ5piv6YCa6L-H5a-56LS-5a6d546J5Y-K5YW25ZGo5Zu05Lq654mp5ZG96L-Q55qE5rex5YWl5YmW5p6Q77yM5Y-N5pig5LqG5bCB5bu656S-5Lya5pyr5pyf5aSn5a625peP55qE6I2j5p6v5YW06KGw5ZKM56S-5Lya546w5a6e55qE5rex5Yi75o-t56S644CC6L-Z5Zub5aSn5ZCN6JGX77yM5ZCE5YW354m56Imy77yM5ZCE5pyJ5Y2D56eL77yM5LiN5LuF5Zyo5Lit5Zu95paH5a2m5Y-y5LiK55WZ5LiL5LqG5rWT5aKo6YeN5b2p55qE5LiA56yU77yM5pu05Zyo5LiW55WM5paH5a2m6aKG5Z-f5YaF5Lqn55Sf5LqG5rex6L-c5b2x5ZON77yM5oiQ5Li65LqG5Lit5Y2O5paH5YyW5LiN5Y-v5oiW57y655qE6YeN6KaB57uE5oiQ6YOo5YiG44CC
返回示例
HTTP/1.1 200 OK
Server: AliyunOSS
Date: Thu, 10 Aug 2023 11:09:00 GMT
Content-Type: application/json;charset=UTF-8
Connection: close
Vary: Accept-Encoding
x-oss-request-id: 6597BB4D4479D831339FCA1D
x-oss-server-time: 2010
Content-Encoding: gzip
{
"RequestId":"6597BB4D4479D831339FCA1D",
"Output":{
"Text":"中国文学宝库中的四大名著被誉为璀璨明珠,代表中国古代小说艺术的巅峰。这四部著名小说包括罗贯中的历史题材《三国演义》,吴承恩的神魔奇幻《西游记》,施耐庵的英雄传奇《水浒传》,以及曹雪芹的家族兴衰经典《红楼梦》。每部作品都独具特色,如《三国演义》描绘了东汉末年群雄争霸的历史,《西游记》展现了一个充满神话和民间故事的神魔世界,《水浒传》讲述了北宋末年梁山好汉反抗封建统治的壮丽史诗,而《红楼梦》则深入剖析了贾宝玉及其周围人物的命运,反映了封建社会末期大家族的兴衰。四大名著不仅在中国文学史上占有重要地位,也在世界文学领域产生了深远影响,是中华文化不可或缺的组成部分。",
"FinishReason":"stop"
}
}
使用SSE进行文档智能摘要
处理方式
待处理文件:example.doc
待摘要文本:“四大名著,被誉为中国文学宝库中的璀璨明珠,是中国古代小说艺术巅峰的象征。这四部举世闻名的小说巨著,分别是罗贯中所创作的历史题材小说《三国演义》,吴承恩笔下的神魔奇幻作品《西游记》,施耐庵创作的英雄传奇小说《水浒传》,以及曹雪芹撰写的人情世故与家族兴衰的经典之作《红楼梦》。《三国演义》以东汉末年及三国时代为背景,生动描绘了群雄争霸的历史画卷;《西游记》则以唐僧师徒取经的故事为主线,融合了大量的神话传说和民间故事,展现出一幅瑰丽奇特的神魔世界;《水浒传》讲述了北宋末年梁山好汉们反抗封建统治者的壮丽史诗,展现了草莽英雄们的豪迈气概;而《红楼梦》则是通过对贾宝玉及其周围人物命运的深入剖析,反映了封建社会末期大家族的荣枯兴衰和社会现实的深刻揭示。这四大名著,各具特色,各有千秋,不仅在中国文学史上留下了浓墨重彩的一笔,更在世界文学领域内产生了深远影响,成为了中华文化不可或缺的重要组成部分。”
返回结果方式:event-stream
处理示例
POST /demo.doc?x-oss-process HTTP/1.1
Host: doc-demo.oss-cn-hangzhou.aliyuncs.com
Date: Fri, 28 Oct 2022 06:40:10 GMT
Authorization: OSS qn6q**************:77Dv****************
x-oss-process=doc/summarize,format_event-stream,content__5Zub5aSn5ZCN6JGX77yM6KKr6KqJ5Li65Lit5Zu95paH5a2m5a6d5bqT5Lit55qE55KA55Ko5piO54-g77yM5piv5Lit5Zu95Y-k5Luj5bCP6K-06Im65pyv5beF5bOw55qE6LGh5b6B44CC6L-Z5Zub6YOo5Li-5LiW6Ze75ZCN55qE5bCP6K-05beo6JGX77yM5YiG5Yir5piv572X6LSv5Lit5omA5Yib5L2c55qE5Y6G5Y-y6aKY5p2Q5bCP6K-044CK5LiJ5Zu95ryU5LmJ44CL77yM5ZC05om_5oGp56yU5LiL55qE56We6a2U5aWH5bm75L2c5ZOB44CK6KW_5ri46K6w44CL77yM5pa96ICQ5bq15Yib5L2c55qE6Iux6ZuE5Lyg5aWH5bCP6K-044CK5rC05rWS5Lyg44CL77yM5Lul5Y-K5pu56Zuq6Iq55pKw5YaZ55qE5Lq65oOF5LiW5pWF5LiO5a625peP5YW06KGw55qE57uP5YW45LmL5L2c44CK57qi5qW85qKm44CL44CC44CK5LiJ5Zu95ryU5LmJ44CL5Lul5Lic5rGJ5pyr5bm05Y-K5LiJ5Zu95pe25Luj5Li66IOM5pmv77yM55Sf5Yqo5o-P57uY5LqG576k6ZuE5LqJ6Zy455qE5Y6G5Y-y55S75Y2377yb44CK6KW_5ri46K6w44CL5YiZ5Lul5ZSQ5YOn5biI5b6S5Y-W57uP55qE5pWF5LqL5Li65Li757q_77yM6J6N5ZCI5LqG5aSn6YeP55qE56We6K-d5Lyg6K-05ZKM5rCR6Ze05pWF5LqL77yM5bGV546w5Ye65LiA5bmF55Gw5Li95aWH54m555qE56We6a2U5LiW55WM77yb44CK5rC05rWS5Lyg44CL6K6y6L-w5LqG5YyX5a6L5pyr5bm05qKB5bGx5aW95rGJ5Lus5Y-N5oqX5bCB5bu657uf5rK76ICF55qE5aOu5Li95Y-y6K-X77yM5bGV546w5LqG6I2J6I696Iux6ZuE5Lus55qE6LGq6L-I5rCU5qaC77yb6ICM44CK57qi5qW85qKm44CL5YiZ5piv6YCa6L-H5a-56LS-5a6d546J5Y-K5YW25ZGo5Zu05Lq654mp5ZG96L-Q55qE5rex5YWl5YmW5p6Q77yM5Y-N5pig5LqG5bCB5bu656S-5Lya5pyr5pyf5aSn5a625peP55qE6I2j5p6v5YW06KGw5ZKM56S-5Lya546w5a6e55qE5rex5Yi75o-t56S644CC6L-Z5Zub5aSn5ZCN6JGX77yM5ZCE5YW354m56Imy77yM5ZCE5pyJ5Y2D56eL77yM5LiN5LuF5Zyo5Lit5Zu95paH5a2m5Y-y5LiK55WZ5LiL5LqG5rWT5aKo6YeN5b2p55qE5LiA56yU77yM5pu05Zyo5LiW55WM5paH5a2m6aKG5Z-f5YaF5Lqn55Sf5LqG5rex6L-c5b2x5ZON77yM5oiQ5Li65LqG5Lit5Y2O5paH5YyW5LiN5Y-v5oiW57y655qE6YeN6KaB57uE5oiQ6YOo5YiG44CC
返回示例
HTTP/1.1 200 OK
Server: AliyunOSS
Date: Thu, 10 Aug 2023 11:20:11 GMT
Content-Type: text/event-stream;charset=UTF-8
Transfer-Encoding: chunked
Connection: close
x-oss-request-id: 64D4C7EA88339E30351A6A2E
x-oss-server-time: 587
id: 0
event: Result
data: {"RequestId":"669F7CE338492236349AF037","Output":{"Text":"中国","FinishReason":"null"}}
id: 1
event: Result
data: {"RequestId":"669F7CE338492236349AF037","Output":{"Text":"中国文学","FinishReason":"null"}}
id: 2
event: Result
data: {"RequestId":"669F7CE338492236349AF037","Output":{"Text":"中国文学宝","FinishReason":"null"}}
id: 3
event: Result
data: {"RequestId":"669F7CE338492236349AF037","Output":{"Text":"中国文学宝库","FinishReason":"null"}}
id: 4
event: Result
data: {"RequestId":"669F7CE338492236349AF037","Output":{"Text":"中国文学宝库中的四大名著","FinishReason":"null"}}
id: 5
event: Result
data: {"RequestId":"669F7CE338492236349AF037","Output":{"Text":"中国文学宝库中的四大名著被誉为璀璨明珠,","FinishReason":"null"}}
id: 6
event: Result
data: {"RequestId":"669F7CE338492236349AF037","Output":{"Text":"中国文学宝库中的四大名著被誉为璀璨明珠,代表中国古代小说艺术","FinishReason":"null"}}
id: 7
event: Result
data: {"RequestId":"669F7CE338492236349AF037","Output":{"Text":"中国文学宝库中的四大名著被誉为璀璨明珠,代表中国古代小说艺术的巅峰。这","FinishReason":"null"}}
id: 8
event: Result
data: {"RequestId":"669F7CE338492236349AF037","Output":{"Text":"中国文学宝库中的四大名著被誉为璀璨明珠,代表中国古代小说艺术的巅峰。这四部著名小说","FinishReason":"null"}}
id: 9
event: Result
data: {"RequestId":"669F7CE338492236349AF037","Output":{"Text":"中国文学宝库中的四大名著被誉为璀璨明珠,代表中国古代小说艺术的巅峰。这四部著名小说包括罗贯中的","FinishReason":"null"}}
id: 10
event: Result
data: {"RequestId":"669F7CE338492236349AF037","Output":{"Text":"中国文学宝库中的四大名著被誉为璀璨明珠,代表中国古代小说艺术的巅峰。这四部著名小说包括罗贯中的历史题材《三国","FinishReason":"null"}}
id: 11
event: Result
data: {"RequestId":"669F7CE338492236349AF037","Output":{"Text":"中国文学宝库中的四大名著被誉为璀璨明珠,代表中国古代小说艺术的巅峰。这四部著名小说包括罗贯中的历史题材《三国演义》,吴","FinishReason":"null"}}
id: 12
event: Result
data: {"RequestId":"669F7CE338492236349AF037","Output":{"Text":"中国文学宝库中的四大名著被誉为璀璨明珠,代表中国古代小说艺术的巅峰。这四部著名小说包括罗贯中的历史题材《三国演义》,吴承恩的神","FinishReason":"null"}}
id: 13
event: Result
data: {"RequestId":"669F7CE338492236349AF037","Output":{"Text":"中国文学宝库中的四大名著被誉为璀璨明珠,代表中国古代小说艺术的巅峰。这四部著名小说包括罗贯中的历史题材《三国演义》,吴承恩的神魔奇幻《西","FinishReason":"null"}}
id: 14
event: Result
data: {"RequestId":"669F7CE338492236349AF037","Output":{"Text":"中国文学宝库中的四大名著被誉为璀璨明珠,代表中国古代小说艺术的巅峰。这四部著名小说包括罗贯中的历史题材《三国演义》,吴承恩的神魔奇幻《西游记》,施","FinishReason":"null"}}
id: 15
event: Result
data: {"RequestId":"669F7CE338492236349AF037","Output":{"Text":"中国文学宝库中的四大名著被誉为璀璨明珠,代表中国古代小说艺术的巅峰。这四部著名小说包括罗贯中的历史题材《三国演义》,吴承恩的神魔奇幻《西游记》,施耐庵的英雄","FinishReason":"null"}}
id: 16
event: Result
data: {"RequestId":"669F7CE338492236349AF037","Output":{"Text":"中国文学宝库中的四大名著被誉为璀璨明珠,代表中国古代小说艺术的巅峰。这四部著名小说包括罗贯中的历史题材《三国演义》,吴承恩的神魔奇幻《西游记》,施耐庵的英雄传奇《水浒","FinishReason":"null"}}
id: 17
event: Result
data: {"RequestId":"669F7CE338492236349AF037","Output":{"Text":"中国文学宝库中的四大名著被誉为璀璨明珠,代表中国古代小说艺术的巅峰。这四部著名小说包括罗贯中的历史题材《三国演义》,吴承恩的神魔奇幻《西游记》,施耐庵的英雄传奇《水浒传》,以及曹","FinishReason":"null"}}
id: 18
event: Result
data: {"RequestId":"669F7CE338492236349AF037","Output":{"Text":"中国文学宝库中的四大名著被誉为璀璨明珠,代表中国古代小说艺术的巅峰。这四部著名小说包括罗贯中的历史题材《三国演义》,吴承恩的神魔奇幻《西游记》,施耐庵的英雄传奇《水浒传》,以及曹雪芹的家族","FinishReason":"null"}}
id: 19
event: Result
data: {"RequestId":"669F7CE338492236349AF037","Output":{"Text":"中国文学宝库中的四大名著被誉为璀璨明珠,代表中国古代小说艺术的巅峰。这四部著名小说包括罗贯中的历史题材《三国演义》,吴承恩的神魔奇幻《西游记》,施耐庵的英雄传奇《水浒传》,以及曹雪芹的家族兴衰经典《","FinishReason":"null"}}
id: 20
event: Result
data: {"RequestId":"669F7CE338492236349AF037","Output":{"Text":"中国文学宝库中的四大名著被誉为璀璨明珠,代表中国古代小说艺术的巅峰。这四部著名小说包括罗贯中的历史题材《三国演义》,吴承恩的神魔奇幻《西游记》,施耐庵的英雄传奇《水浒传》,以及曹雪芹的家族兴衰经典《红楼梦》。每","FinishReason":"null"}}
id: 21
event: Result
data: {"RequestId":"669F7CE338492236349AF037","Output":{"Text":"中国文学宝库中的四大名著被誉为璀璨明珠,代表中国古代小说艺术的巅峰。这四部著名小说包括罗贯中的历史题材《三国演义》,吴承恩的神魔奇幻《西游记》,施耐庵的英雄传奇《水浒传》,以及曹雪芹的家族兴衰经典《红楼梦》。每部作品都独具","FinishReason":"null"}}
id: 22
event: Result
data: {"RequestId":"669F7CE338492236349AF037","Output":{"Text":"中国文学宝库中的四大名著被誉为璀璨明珠,代表中国古代小说艺术的巅峰。这四部著名小说包括罗贯中的历史题材《三国演义》,吴承恩的神魔奇幻《西游记》,施耐庵的英雄传奇《水浒传》,以及曹雪芹的家族兴衰经典《红楼梦》。每部作品都独具特色,如《","FinishReason":"null"}}
id: 23
event: Result
data: {"RequestId":"669F7CE338492236349AF037","Output":{"Text":"中国文学宝库中的四大名著被誉为璀璨明珠,代表中国古代小说艺术的巅峰。这四部著名小说包括罗贯中的历史题材《三国演义》,吴承恩的神魔奇幻《西游记》,施耐庵的英雄传奇《水浒传》,以及曹雪芹的家族兴衰经典《红楼梦》。每部作品都独具特色,如《三国演义》","FinishReason":"null"}}
id: 24
event: Result
data: {"RequestId":"669F7CE338492236349AF037","Output":{"Text":"中国文学宝库中的四大名著被誉为璀璨明珠,代表中国古代小说艺术的巅峰。这四部著名小说包括罗贯中的历史题材《三国演义》,吴承恩的神魔奇幻《西游记》,施耐庵的英雄传奇《水浒传》,以及曹雪芹的家族兴衰经典《红楼梦》。每部作品都独具特色,如《三国演义》描绘了东汉","FinishReason":"null"}}
id: 25
event: Result
data: {"RequestId":"669F7CE338492236349AF037","Output":{"Text":"中国文学宝库中的四大名著被誉为璀璨明珠,代表中国古代小说艺术的巅峰。这四部著名小说包括罗贯中的历史题材《三国演义》,吴承恩的神魔奇幻《西游记》,施耐庵的英雄传奇《水浒传》,以及曹雪芹的家族兴衰经典《红楼梦》。每部作品都独具特色,如《三国演义》描绘了东汉末年群雄","FinishReason":"null"}}
id: 26
event: Result
data: {"RequestId":"669F7CE338492236349AF037","Output":{"Text":"中国文学宝库中的四大名著被誉为璀璨明珠,代表中国古代小说艺术的巅峰。这四部著名小说包括罗贯中的历史题材《三国演义》,吴承恩的神魔奇幻《西游记》,施耐庵的英雄传奇《水浒传》,以及曹雪芹的家族兴衰经典《红楼梦》。每部作品都独具特色,如《三国演义》描绘了东汉末年群雄争霸的历史,《西","FinishReason":"null"}}
id: 27
event: Result
data: {"RequestId":"669F7CE338492236349AF037","Output":{"Text":"中国文学宝库中的四大名著被誉为璀璨明珠,代表中国古代小说艺术的巅峰。这四部著名小说包括罗贯中的历史题材《三国演义》,吴承恩的神魔奇幻《西游记》,施耐庵的英雄传奇《水浒传》,以及曹雪芹的家族兴衰经典《红楼梦》。每部作品都独具特色,如《三国演义》描绘了东汉末年群雄争霸的历史,《西游记》展现","FinishReason":"null"}}
id: 28
event: Result
data: {"RequestId":"669F7CE338492236349AF037","Output":{"Text":"中国文学宝库中的四大名著被誉为璀璨明珠,代表中国古代小说艺术的巅峰。这四部著名小说包括罗贯中的历史题材《三国演义》,吴承恩的神魔奇幻《西游记》,施耐庵的英雄传奇《水浒传》,以及曹雪芹的家族兴衰经典《红楼梦》。每部作品都独具特色,如《三国演义》描绘了东汉末年群雄争霸的历史,《西游记》展现了一个充满神话和","FinishReason":"null"}}
id: 29
event: Result
data: {"RequestId":"669F7CE338492236349AF037","Output":{"Text":"中国文学宝库中的四大名著被誉为璀璨明珠,代表中国古代小说艺术的巅峰。这四部著名小说包括罗贯中的历史题材《三国演义》,吴承恩的神魔奇幻《西游记》,施耐庵的英雄传奇《水浒传》,以及曹雪芹的家族兴衰经典《红楼梦》。每部作品都独具特色,如《三国演义》描绘了东汉末年群雄争霸的历史,《西游记》展现了一个充满神话和民间故事的神","FinishReason":"null"}}
id: 30
event: Result
data: {"RequestId":"669F7CE338492236349AF037","Output":{"Text":"中国文学宝库中的四大名著被誉为璀璨明珠,代表中国古代小说艺术的巅峰。这四部著名小说包括罗贯中的历史题材《三国演义》,吴承恩的神魔奇幻《西游记》,施耐庵的英雄传奇《水浒传》,以及曹雪芹的家族兴衰经典《红楼梦》。每部作品都独具特色,如《三国演义》描绘了东汉末年群雄争霸的历史,《西游记》展现了一个充满神话和民间故事的神魔世界,《水","FinishReason":"null"}}
id: 31
event: Result
data: {"RequestId":"669F7CE338492236349AF037","Output":{"Text":"中国文学宝库中的四大名著被誉为璀璨明珠,代表中国古代小说艺术的巅峰。这四部著名小说包括罗贯中的历史题材《三国演义》,吴承恩的神魔奇幻《西游记》,施耐庵的英雄传奇《水浒传》,以及曹雪芹的家族兴衰经典《红楼梦》。每部作品都独具特色,如《三国演义》描绘了东汉末年群雄争霸的历史,《西游记》展现了一个充满神话和民间故事的神魔世界,《水浒传》讲述了","FinishReason":"null"}}
id: 32
event: Result
data: {"RequestId":"669F7CE338492236349AF037","Output":{"Text":"中国文学宝库中的四大名著被誉为璀璨明珠,代表中国古代小说艺术的巅峰。这四部著名小说包括罗贯中的历史题材《三国演义》,吴承恩的神魔奇幻《西游记》,施耐庵的英雄传奇《水浒传》,以及曹雪芹的家族兴衰经典《红楼梦》。每部作品都独具特色,如《三国演义》描绘了东汉末年群雄争霸的历史,《西游记》展现了一个充满神话和民间故事的神魔世界,《水浒传》讲述了北宋末年梁","FinishReason":"null"}}
id: 33
event: Result
data: {"RequestId":"669F7CE338492236349AF037","Output":{"Text":"中国文学宝库中的四大名著被誉为璀璨明珠,代表中国古代小说艺术的巅峰。这四部著名小说包括罗贯中的历史题材《三国演义》,吴承恩的神魔奇幻《西游记》,施耐庵的英雄传奇《水浒传》,以及曹雪芹的家族兴衰经典《红楼梦》。每部作品都独具特色,如《三国演义》描绘了东汉末年群雄争霸的历史,《西游记》展现了一个充满神话和民间故事的神魔世界,《水浒传》讲述了北宋末年梁山好汉反抗","FinishReason":"null"}}
id: 34
event: Result
data: {"RequestId":"669F7CE338492236349AF037","Output":{"Text":"中国文学宝库中的四大名著被誉为璀璨明珠,代表中国古代小说艺术的巅峰。这四部著名小说包括罗贯中的历史题材《三国演义》,吴承恩的神魔奇幻《西游记》,施耐庵的英雄传奇《水浒传》,以及曹雪芹的家族兴衰经典《红楼梦》。每部作品都独具特色,如《三国演义》描绘了东汉末年群雄争霸的历史,《西游记》展现了一个充满神话和民间故事的神魔世界,《水浒传》讲述了北宋末年梁山好汉反抗封建统治的壮","FinishReason":"null"}}
id: 35
event: Result
data: {"RequestId":"669F7CE338492236349AF037","Output":{"Text":"中国文学宝库中的四大名著被誉为璀璨明珠,代表中国古代小说艺术的巅峰。这四部著名小说包括罗贯中的历史题材《三国演义》,吴承恩的神魔奇幻《西游记》,施耐庵的英雄传奇《水浒传》,以及曹雪芹的家族兴衰经典《红楼梦》。每部作品都独具特色,如《三国演义》描绘了东汉末年群雄争霸的历史,《西游记》展现了一个充满神话和民间故事的神魔世界,《水浒传》讲述了北宋末年梁山好汉反抗封建统治的壮丽史诗,而","FinishReason":"null"}}
id: 36
event: Result
data: {"RequestId":"669F7CE338492236349AF037","Output":{"Text":"中国文学宝库中的四大名著被誉为璀璨明珠,代表中国古代小说艺术的巅峰。这四部著名小说包括罗贯中的历史题材《三国演义》,吴承恩的神魔奇幻《西游记》,施耐庵的英雄传奇《水浒传》,以及曹雪芹的家族兴衰经典《红楼梦》。每部作品都独具特色,如《三国演义》描绘了东汉末年群雄争霸的历史,《西游记》展现了一个充满神话和民间故事的神魔世界,《水浒传》讲述了北宋末年梁山好汉反抗封建统治的壮丽史诗,而《红楼梦》则","FinishReason":"null"}}
id: 37
event: Result
data: {"RequestId":"669F7CE338492236349AF037","Output":{"Text":"中国文学宝库中的四大名著被誉为璀璨明珠,代表中国古代小说艺术的巅峰。这四部著名小说包括罗贯中的历史题材《三国演义》,吴承恩的神魔奇幻《西游记》,施耐庵的英雄传奇《水浒传》,以及曹雪芹的家族兴衰经典《红楼梦》。每部作品都独具特色,如《三国演义》描绘了东汉末年群雄争霸的历史,《西游记》展现了一个充满神话和民间故事的神魔世界,《水浒传》讲述了北宋末年梁山好汉反抗封建统治的壮丽史诗,而《红楼梦》则深入剖析了贾","FinishReason":"null"}}
id: 38
event: Result
data: {"RequestId":"669F7CE338492236349AF037","Output":{"Text":"中国文学宝库中的四大名著被誉为璀璨明珠,代表中国古代小说艺术的巅峰。这四部著名小说包括罗贯中的历史题材《三国演义》,吴承恩的神魔奇幻《西游记》,施耐庵的英雄传奇《水浒传》,以及曹雪芹的家族兴衰经典《红楼梦》。每部作品都独具特色,如《三国演义》描绘了东汉末年群雄争霸的历史,《西游记》展现了一个充满神话和民间故事的神魔世界,《水浒传》讲述了北宋末年梁山好汉反抗封建统治的壮丽史诗,而《红楼梦》则深入剖析了贾宝玉及其周围人物","FinishReason":"null"}}
id: 39
event: Result
data: {"RequestId":"669F7CE338492236349AF037","Output":{"Text":"中国文学宝库中的四大名著被誉为璀璨明珠,代表中国古代小说艺术的巅峰。这四部著名小说包括罗贯中的历史题材《三国演义》,吴承恩的神魔奇幻《西游记》,施耐庵的英雄传奇《水浒传》,以及曹雪芹的家族兴衰经典《红楼梦》。每部作品都独具特色,如《三国演义》描绘了东汉末年群雄争霸的历史,《西游记》展现了一个充满神话和民间故事的神魔世界,《水浒传》讲述了北宋末年梁山好汉反抗封建统治的壮丽史诗,而《红楼梦》则深入剖析了贾宝玉及其周围人物的命运,反映了封建","FinishReason":"null"}}
id: 40
event: Result
data: {"RequestId":"669F7CE338492236349AF037","Output":{"Text":"中国文学宝库中的四大名著被誉为璀璨明珠,代表中国古代小说艺术的巅峰。这四部著名小说包括罗贯中的历史题材《三国演义》,吴承恩的神魔奇幻《西游记》,施耐庵的英雄传奇《水浒传》,以及曹雪芹的家族兴衰经典《红楼梦》。每部作品都独具特色,如《三国演义》描绘了东汉末年群雄争霸的历史,《西游记》展现了一个充满神话和民间故事的神魔世界,《水浒传》讲述了北宋末年梁山好汉反抗封建统治的壮丽史诗,而《红楼梦》则深入剖析了贾宝玉及其周围人物的命运,反映了封建社会末期大家","FinishReason":"null"}}
id: 41
event: Result
data: {"RequestId":"669F7CE338492236349AF037","Output":{"Text":"中国文学宝库中的四大名著被誉为璀璨明珠,代表中国古代小说艺术的巅峰。这四部著名小说包括罗贯中的历史题材《三国演义》,吴承恩的神魔奇幻《西游记》,施耐庵的英雄传奇《水浒传》,以及曹雪芹的家族兴衰经典《红楼梦》。每部作品都独具特色,如《三国演义》描绘了东汉末年群雄争霸的历史,《西游记》展现了一个充满神话和民间故事的神魔世界,《水浒传》讲述了北宋末年梁山好汉反抗封建统治的壮丽史诗,而《红楼梦》则深入剖析了贾宝玉及其周围人物的命运,反映了封建社会末期大家族的兴衰","FinishReason":"null"}}
id: 42
event: Result
data: {"RequestId":"669F7CE338492236349AF037","Output":{"Text":"中国文学宝库中的四大名著被誉为璀璨明珠,代表中国古代小说艺术的巅峰。这四部著名小说包括罗贯中的历史题材《三国演义》,吴承恩的神魔奇幻《西游记》,施耐庵的英雄传奇《水浒传》,以及曹雪芹的家族兴衰经典《红楼梦》。每部作品都独具特色,如《三国演义》描绘了东汉末年群雄争霸的历史,《西游记》展现了一个充满神话和民间故事的神魔世界,《水浒传》讲述了北宋末年梁山好汉反抗封建统治的壮丽史诗,而《红楼梦》则深入剖析了贾宝玉及其周围人物的命运,反映了封建社会末期大家族的兴衰。四大名著","FinishReason":"null"}}
id: 43
event: Result
data: {"RequestId":"669F7CE338492236349AF037","Output":{"Text":"中国文学宝库中的四大名著被誉为璀璨明珠,代表中国古代小说艺术的巅峰。这四部著名小说包括罗贯中的历史题材《三国演义》,吴承恩的神魔奇幻《西游记》,施耐庵的英雄传奇《水浒传》,以及曹雪芹的家族兴衰经典《红楼梦》。每部作品都独具特色,如《三国演义》描绘了东汉末年群雄争霸的历史,《西游记》展现了一个充满神话和民间故事的神魔世界,《水浒传》讲述了北宋末年梁山好汉反抗封建统治的壮丽史诗,而《红楼梦》则深入剖析了贾宝玉及其周围人物的命运,反映了封建社会末期大家族的兴衰。四大名著不仅在中国文学史上","FinishReason":"null"}}
id: 44
event: Result
data: {"RequestId":"669F7CE338492236349AF037","Output":{"Text":"中国文学宝库中的四大名著被誉为璀璨明珠,代表中国古代小说艺术的巅峰。这四部著名小说包括罗贯中的历史题材《三国演义》,吴承恩的神魔奇幻《西游记》,施耐庵的英雄传奇《水浒传》,以及曹雪芹的家族兴衰经典《红楼梦》。每部作品都独具特色,如《三国演义》描绘了东汉末年群雄争霸的历史,《西游记》展现了一个充满神话和民间故事的神魔世界,《水浒传》讲述了北宋末年梁山好汉反抗封建统治的壮丽史诗,而《红楼梦》则深入剖析了贾宝玉及其周围人物的命运,反映了封建社会末期大家族的兴衰。四大名著不仅在中国文学史上占有重要地位,","FinishReason":"null"}}
id: 45
event: Result
data: {"RequestId":"669F7CE338492236349AF037","Output":{"Text":"中国文学宝库中的四大名著被誉为璀璨明珠,代表中国古代小说艺术的巅峰。这四部著名小说包括罗贯中的历史题材《三国演义》,吴承恩的神魔奇幻《西游记》,施耐庵的英雄传奇《水浒传》,以及曹雪芹的家族兴衰经典《红楼梦》。每部作品都独具特色,如《三国演义》描绘了东汉末年群雄争霸的历史,《西游记》展现了一个充满神话和民间故事的神魔世界,《水浒传》讲述了北宋末年梁山好汉反抗封建统治的壮丽史诗,而《红楼梦》则深入剖析了贾宝玉及其周围人物的命运,反映了封建社会末期大家族的兴衰。四大名著不仅在中国文学史上占有重要地位,也在世界文学领域","FinishReason":"null"}}
id: 46
event: Result
data: {"RequestId":"669F7CE338492236349AF037","Output":{"Text":"中国文学宝库中的四大名著被誉为璀璨明珠,代表中国古代小说艺术的巅峰。这四部著名小说包括罗贯中的历史题材《三国演义》,吴承恩的神魔奇幻《西游记》,施耐庵的英雄传奇《水浒传》,以及曹雪芹的家族兴衰经典《红楼梦》。每部作品都独具特色,如《三国演义》描绘了东汉末年群雄争霸的历史,《西游记》展现了一个充满神话和民间故事的神魔世界,《水浒传》讲述了北宋末年梁山好汉反抗封建统治的壮丽史诗,而《红楼梦》则深入剖析了贾宝玉及其周围人物的命运,反映了封建社会末期大家族的兴衰。四大名著不仅在中国文学史上占有重要地位,也在世界文学领域产生了深远影响,","FinishReason":"null"}}
id: 47
event: Result
data: {"RequestId":"669F7CE338492236349AF037","Output":{"Text":"中国文学宝库中的四大名著被誉为璀璨明珠,代表中国古代小说艺术的巅峰。这四部著名小说包括罗贯中的历史题材《三国演义》,吴承恩的神魔奇幻《西游记》,施耐庵的英雄传奇《水浒传》,以及曹雪芹的家族兴衰经典《红楼梦》。每部作品都独具特色,如《三国演义》描绘了东汉末年群雄争霸的历史,《西游记》展现了一个充满神话和民间故事的神魔世界,《水浒传》讲述了北宋末年梁山好汉反抗封建统治的壮丽史诗,而《红楼梦》则深入剖析了贾宝玉及其周围人物的命运,反映了封建社会末期大家族的兴衰。四大名著不仅在中国文学史上占有重要地位,也在世界文学领域产生了深远影响,是中华文化不可或缺的","FinishReason":"null"}}
id: 48
event: Result
data: {"RequestId":"669F7CE338492236349AF037","Output":{"Text":"中国文学宝库中的四大名著被誉为璀璨明珠,代表中国古代小说艺术的巅峰。这四部著名小说包括罗贯中的历史题材《三国演义》,吴承恩的神魔奇幻《西游记》,施耐庵的英雄传奇《水浒传》,以及曹雪芹的家族兴衰经典《红楼梦》。每部作品都独具特色,如《三国演义》描绘了东汉末年群雄争霸的历史,《西游记》展现了一个充满神话和民间故事的神魔世界,《水浒传》讲述了北宋末年梁山好汉反抗封建统治的壮丽史诗,而《红楼梦》则深入剖析了贾宝玉及其周围人物的命运,反映了封建社会末期大家族的兴衰。四大名著不仅在中国文学史上占有重要地位,也在世界文学领域产生了深远影响,是中华文化不可或缺的组成部分。","FinishReason":"stop"}}
使用SDK
以下仅列举常见SDK通过处理参数的方式使用智能文档摘要的代码示例。如需使用其他SDK使用智能文档摘要的代码示例,请参见以下常见SDK自行调整。
Java
要求使用3.17.4及以上版本的Java SDK。
import com.aliyun.oss.*;
import com.aliyun.oss.common.auth.*;
import com.aliyun.oss.common.comm.SignVersion;
import com.aliyun.oss.common.utils.BinaryUtil;
import com.aliyun.oss.common.utils.IOUtils;
import com.aliyun.oss.model.GenericResult;
import com.aliyun.oss.model.ProcessObjectRequest;
import java.io.IOException;
import java.util.Formatter;
public class Demo {
public static void main(String[] args) throws ClientException, com.aliyuncs.exceptions.ClientException {
// yourEndpoint填写Bucket所在地域对应的Endpoint。
String endpoint = "http://oss-cn-hangzhou.aliyuncs.com";
// 填写阿里云通用Region ID,例如cn-hangzhou。
String region = "cn-hangzhou";
// 从环境变量中获取访问凭证。运行本代码示例之前,请确保已设置环境变量OSS_ACCESS_KEY_ID和OSS_ACCESS_KEY_SECRET。
EnvironmentVariableCredentialsProvider credentialsProvider = CredentialsProviderFactory.newEnvironmentVariableCredentialsProvider();
// 指定Bucket名称。
String bucketName = "examplebucket";
// 指定文件名称,作为占位符使用。使用智能文档摘要时,不读取该文件的内容。
String key ="example.docx";
// 指定待提取摘要的文本内容。
String content = "yourContent";
String encodeContent = BinaryUtil.toBase64String(content.getBytes()).replaceAll("\\+","-")
.replaceAll("/","_").replaceAll("=","");
// 创建OSSClient实例。
ClientBuilderConfiguration clientBuilderConfiguration = new ClientBuilderConfiguration();
clientBuilderConfiguration.setSignatureVersion(SignVersion.V4);
OSS ossClient = OSSClientBuilder.create()
.endpoint(endpoint)
.credentialsProvider(credentialsProvider)
.clientConfiguration(clientBuilderConfiguration)
.region(region)
.build();
try {
StringBuilder sbStyle = new StringBuilder();
Formatter styleFormatter = new Formatter(sbStyle);
// 构建智能文档摘要处理指令。
styleFormatter.format("doc/summarize,content_%s",
encodeContent);
System.out.println(sbStyle.toString());
ProcessObjectRequest request = new ProcessObjectRequest(bucketName, key, sbStyle.toString());
GenericResult processResult = ossClient.processObject(request);
String json = IOUtils.readStreamAsString(processResult.getResponse().getContent(), "UTF-8");
processResult.getResponse().getContent().close();
System.out.println(json);
} catch (OSSException oe) {
System.out.println("Caught an OSSException, which means your request made it to OSS, "
+ "but was rejected with an error response for some reason.");
System.out.println("Error Message:" + oe.getErrorMessage());
System.out.println("Error Code:" + oe.getErrorCode());
System.out.println("Request ID:" + oe.getRequestId());
System.out.println("Host ID:" + oe.getHostId());
} catch (ClientException ce) {
System.out.println("Caught an ClientException, which means the client encountered "
+ "a serious internal problem while trying to communicate with OSS, "
+ "such as not being able to access the network.");
System.out.println("Error Message:" + ce.getMessage());
} catch (IOException e) {
e.printStackTrace();
} finally {
if (ossClient != null) {
ossClient.shutdown();
}
}
}
}
PHP
要求使用PHP SDK 2.7.0及以上版本。
<?php
// 从环境变量中获取访问凭证。运行本代码示例之前,请确保已设置环境变量OSS_ACCESS_KEY_ID和OSS_ACCESS_KEY_SECRET。
$ak = getenv('OSS_ACCESS_KEY_ID');
$sk = getenv('OSS_ACCESS_KEY_SECRET');
// 指定Bucket名称,例如examplebucket。
$bucket = 'examplebucket';
// 指定文件名称,仅作为占位符使用。使用智能文档摘要时,不读取该文件的内容。
$objectKey = 'example.docx';
// 指定待提取摘要的文本内容。
$txt = "yourTxt";
$base64url = str_replace(['+', '/', '='], ['-', '_', ''], base64_encode($txt));
// 构建智能文档摘要处理指令。
$body = sprintf("x-oss-process=doc/summarize,content_%s", $base64url);
$httpVerb = 'POST';
$contentMd5 = base64_encode(md5($body, true));
$contentType = '';
$date = gmdate('D, d M Y H:i:s T');
$stringToSign = $httpVerb . "\n" . $contentMd5 . "\n" . $contentType . "\n" . $date . "\n" . "/{$bucket}/{$objectKey}?x-oss-process";
$signature = base64_encode(hash_hmac('sha1', $stringToSign, $sk, true));
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, "http://{$bucket}.oss-cn-hangzhou.aliyuncs.com/{$objectKey}?x-oss-process");
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'POST');
curl_setopt($ch, CURLOPT_HTTPHEADER, array(
'Date: ' . $date,
'Authorization: OSS ' . $ak . ':' . $signature,
'Content-Type: ' . $contentType,
'Content-Md5:' . $contentMd5,
));
curl_setopt($ch, CURLOPT_POSTFIELDS, $body);
$response = curl_exec($ch);
$httpcode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);
if ($response === false) {
echo "Error: " . curl_error($ch);
} else {
if ($httpcode == 200) {
var_dump($response);
} else {
echo "Error: HTTP code " . $httpcode;
}
}
Go
要求使用Go SDK 3.0.2及以上版本。
package main
import (
"encoding/base64"
"encoding/json"
"fmt"
"io"
"os"
"strings"
"github.com/aliyun/aliyun-oss-go-sdk/oss"
)
type TextData struct {
RequestId string `json:"RequestId"`
Output struct {
Text string `json:"Text"`
FinishReason string `json:"FinishReason"`
} `json:"Output"`
}
func main() {
// 从环境变量中获取临时访问凭证。运行本代码示例之前,请确保已设置环境变量OSS_ACCESS_KEY_ID、OSS_ACCESS_KEY_SECRET、OSS_SESSION_TOKEN。
provider, err := oss.NewEnvironmentVariableCredentialsProvider()
if err != nil {
fmt.Println("Error:", err)
os.Exit(-1)
}
// 创建OSSClient实例。
client, err := oss.New("https://oss-cn-hangzhou.aliyuncs.com", "", "", oss.SetCredentialsProvider(&provider), oss.AuthVersion(oss.AuthV4), oss.Region("cn-hangzhou"))
if err != nil {
fmt.Println("Error:", err)
os.Exit(-1)
}
// 填写Bucket名称,例如examplebucket。
bucketName := "examplebucket"
bucket, err := client.Bucket(bucketName)
if err != nil {
fmt.Println("Error:", err)
os.Exit(-1)
}
params := make(map[string]interface{})
params["x-oss-process"] = nil
// 指定待提取摘要的文本内容。
txt := "yourTxt"
// 构建智能文档摘要处理指令。
data := fmt.Sprintf("x-oss-process=doc/summarize,content_%v", base64.URLEncoding.EncodeToString([]byte(txt)))
// example.docx是Bucket中的某个文件,作为占位符使用。使用智能文档摘要时,不读取该文件的内容。
response, err := bucket.Do("POST", "example.docx", params, nil, strings.NewReader(data), nil)
if err != nil {
fmt.Println("Error:", err)
os.Exit(-1)
}
defer response.Body.Close()
jsonData, err := io.ReadAll(response.Body)
if err != nil {
fmt.Println("Error:", err)
os.Exit(-1)
}
var text TextData
err = json.Unmarshal(jsonData, &text)
if err != nil {
fmt.Println("Error:", err)
os.Exit(-1)
}
fmt.Printf("RequestId:%v\n", text.RequestId)
fmt.Printf("Text:%v\n", text.Output.Text)
fmt.Printf("FinishReason:%v\n", text.Output.FinishReason)
}