智能文檔摘要 - Object Storage Service

智能文檔摘要用於快速識別長篇文檔中的核心要點、關鍵句子或段落，自動產生文檔內容的簡短概括或提取關鍵資訊，協助您高效地瞭解文檔主旨，節省閱讀和理解全文所需的時間。

前提條件

已綁定IMM Project。通過OSS控制台綁定的具體操作，請參見快速入門。通過API綁定的具體操作，請參見AttachOSSBucket - 綁定Object Storage Service桶。

注意事項

智能文檔摘要功能僅支援同步處理（x-oss-process處理方式）。
該介面需採用POST方式請求。
不支援匿名訪問。
必須擁有IMM處理所需的相關許可權。更多資訊，請參見許可權。

參數說明

操作名稱：doc/summarize

具體參數如下表所示。

參數

類型

是否必須

描述

content

string

是

需要摘要的文檔內容，需經過URL安全的Base64編碼。

說明

最大支援長度為19500位元組。

format

string

否

指定返回資料的方式，取值：

json（預設值）：普通模式，會返回一個資料包，其中包含完整的請求結果。
event-stream：SSE模式，會收到多個資料包，其中每次都包含全量的資料。

返回參數如下表所示：

參數	類型	描述
RequestId	string	當次請求的Request ID。
Output	struct	輸出的結果內容。子節點：Text, FinishReason
Text	string	本次請求的處理得到的結果內容。父節點：Output
FinishReason	string	表明當前產生結果的現狀。取值： null：正在產生 stop：產生結束父節點：Output

使用REST API

說明

使用REST API進行文檔智能摘要時需要指定檔案名稱，但檔案名稱僅作為預留位置使用。使用智能文檔摘要時，只識別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: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e

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 /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: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e

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: 669F7CE338492236349AF037
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執行個體。
        // 當OSSClient執行個體不再使用時，調用shutdown方法以釋放資源。
        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)
}