文本自动摘要

请求地址	https://cx4.cn/openApi/ai/summary 复制
请求方式	GET / POST
接口标识	ai_summary
鉴权方式	必须 四种方式任选其一：Header「X-Api-Key」/ Header「Authorization: Bearer 你的key」/ URL 参数「?key=你的key」/ POST 参数「key」

参数名	类型	必填	说明	示例
text	string	是	待摘要的文本，最多 10000 字，建议 200 字以上效果更好	...
ratio	float	否	摘要占原文的比例，0.1-0.8	0.3
max_sentences	int	否	摘要最多包含几句，1-10	3

下表字段位于返回结构的 data 内；外层 code / message 为全平台统一格式，不在此重复列出。

参数名	类型	说明	示例
ok	bool	是否成功	true
text_length	int	原文长度	158
sentence_count	int	原文句子数	4
summary	string	摘要文本	...
summary_length	int	摘要长度	52
count	int	摘要句数	1
compress_ratio	float	压缩率百分比	32.9
sentences	array	入选句子明细，含原文序号、得分与内容	[]
cached	bool	是否命中缓存	false

成功

{
    "code": 200,
    "message": "操作成功",
    "data": {
        "ok": true,
        "text_length": 144,
        "sentence_count": 4,
        "summary": "机器学习是人工智能的核心，是使计算机具有智能的根本途径。自然语言处理让计算机能够理解和生成人类语言，是人工智能的重要应用方向。",
        "summary_length": 63,
        "count": 2,
        "compress_ratio": 0.438,
        "sentences": [
            {
                "index": 0,
                "score": 0.799918,
                "text": "人工智能是研究、开发用于模拟、延伸和扩展人的智能的理论、方法、技术及应用系统的一门新的技术科学。"
            },
            {
                "index": 1,
                "score": 1.578447,
                "text": "机器学习是人工智能的核心，是使计算机具有智能的根本途径。"
            },
            {
                "index": 2,
                "score": 0.735006,
                "text": "深度学习是机器学习的一个分支，它通过多层神经网络实现特征自动提取。"
            },
            {
                "index": 3,
                "score": 0.886629,
                "text": "自然语言处理让计算机能够理解和生成人类语言，是人工智能的重要应用方向。"
            }
        ],
        "cached": true
    }
}

失败

{
    "code": 400,
    "message": "缺少待摘要的文本",
    "data": null
}

状态码	说明
200	调用成功
400	缺少必填参数或参数格式有误
401	密钥缺失或无效
402	余额不足，请充值后重试
403	未开通该接口，请在本页开通后调用
404	接口不存在或已下架
429	触发限流，请稍后重试
500	接口调用失败（已扣款的会自动退款）

cURL 复制

curl -X POST "https://cx4.cn/openApi/ai/summary" -H "X-Api-Key: 你的SecretKey" -d "text=...&ratio=0.3&max_sentences=3"

JavaScript 复制

fetch('https://cx4.cn/openApi/ai/summary', {
  method: 'POST',
  headers: {
    'X-Api-Key': '你的SecretKey',
    'Content-Type': 'application/x-www-form-urlencoded'
  },
  body: 'text=...&ratio=0.3&max_sentences=3'
})
.then(res => res.json())
.then(data => console.log(data));

PHP 复制

post('https://cx4.cn/openApi/ai/summary', [
    'headers' => ['X-Api-Key' => '你的SecretKey'],
    'form_params' => ['text' => '...', 'ratio' => '0.3', 'max_sentences' => '3'],
]);
echo $response->getBody();

Java 复制

HttpClient client = HttpClient.newHttpClient();
HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://cx4.cn/openApi/ai/summary"))
    .header("X-Api-Key", "你的SecretKey")
    .header("Content-Type", "application/x-www-form-urlencoded")
    .POST(HttpRequest.BodyPublishers.ofString("text=...&ratio=0.3&max_sentences=3"))
    .build();
HttpResponse response = client.send(
        request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());

Python 复制

import requests

res = requests.post('https://cx4.cn/openApi/ai/summary',
    headers={'X-Api-Key': '你的SecretKey'},
    data={'text': '...', 'ratio': '0.3', 'max_sentences': '3'})
print(res.json())

登录后可在线测试： 立即登录