Skip to main content
POST

接口说明

AIGC文本改写接口是 Paper Panda 的核心服务,提供基于大语言模型的智能文本改写能力。

主要特性

  • 多种改写模式: 支持11种改写类型,满足不同场景需求
  • 按字数计费: 改写成功后自动扣费,失败不收费
  • 实时处理: 同步返回改写结果
  • 欠费保护: 余额不足时创建欠费订单,充值后可查看结果

认证方式

string
required
Bearer Token认证,支持API Key或JWT Token

请求参数

string
required
要改写的文本内容
  • 长度限制: 50-6,000 字符
  • 编码: UTF-8
  • 格式: 纯文本,无需特殊格式
string
required
服务类型,决定改写策略和价格
integer
required
改写类型ID,决定具体的改写算法
推荐选择: 大多数场景使用 rewrite_type=1(标准改写)或 rewrite_type=3(通用改写)

响应参数

number
required
本次消费金额(元)
integer
required
响应状态码
  • 200: 改写成功
  • 500: 改写失败
string
required
改写后的文本内容(成功时)或错误提示(失败时)
string
required
响应消息
  • 成功: "改写成功"
  • 欠费: "处理完成, 因已欠费, 需充值回正后, 进入右侧「生成记录」页面查看结果!"
  • 失败: "处理失败: {错误原因}"

请求示例

响应示例

错误码说明

计费规则

费用计算

改写费用根据以下因素计算:
  1. 文本长度: 按照实际字符数计费(不含换行符)
  2. 服务类型: 不同 service_type 价格不同
  3. 改写类型: 不同 rewrite_type 可能有差异

扣费时机

  • 改写成功: 自动扣除预估费用
  • 改写失败: 不扣费,创建失败记录供追溯
  • ⚠️ 余额不足: 创建欠费订单,充值后可查看结果
重要提示: 改写前系统会预估费用并检查余额,确保有足够余额再调用。

使用限制

并发限制

  • 每个用户最多同时处理 3个 改写请求
  • 超出限制返回 429 错误

频率限制

  • 默认 QPM(每分钟请求数):10次/分钟
  • 可通过”API密钥管理”申请提升配额

文本长度

  • 最小长度:50 字符
  • 最大长度:6,000 字符
  • 超出限制返回 422 参数验证错误

最佳实践

场景推荐:
  • 知网查重:选择 rewrite_type=1rewrite_type=7
  • 维普查重:选择 rewrite_type=2rewrite_type=8
  • 通用场景:选择 rewrite_type=3rewrite_type=9
  • 英文文本:选择 rewrite_type=4
性价比优先: 使用 service_type=ai-reduce-value
建议方案:
  1. 将长文本分段(每段不超过5000字符)
  2. 使用队列管理改写任务
  3. 控制并发数(最多3个)
  4. 遵守QPM限制
  5. 实现重试机制(失败后等待重试)
优化建议:
  • 确保原文语句通顺
  • 避免包含大量特殊符号
  • 合理控制文本长度
  • 选择匹配的改写类型
  • 多次改写取最佳结果
预防措施:
  1. 调用前先查询余额
  2. 预估费用:字数/1000 * 单价
  3. 预留足够余额缓冲
  4. 设置余额预警
  5. 及时充值

相关接口

查询余额

改写前查询账户余额

技术支持

遇到问题?我们随时为您提供帮助:

Authorizations

Authorization
string
header
required

使用API Key进行认证,格式:Bearer ak_xxxxxxxxxxxxxxxx

Body

application/json
content
string
required

要改写的文本内容,1-20000字符

Required string length: 1 - 20000
Example:

"人工智能是研究如何使计算机模拟人类智能的一门科学。"

service_type
enum<string>
required

服务类型:ai-reduce-value(降AI超值)、ai-reduce(降AI)、duplicate-reduce(降重)、ai-duplicate(降AI+降重)、advance(高级咨询)

Available options:
ai-reduce-value,
ai-reduce,
duplicate-reduce,
ai-duplicate,
advance
Example:

"ai-reduce-value"

rewrite_type
integer
required

改写类型ID,1=标准改写,2=维普改写,3=通用改写,4=英文改写,5=通用降重,6=GIZIDA改写,7=双降知网,8=双降维普,9=双降通用,10=双降GIZIDA,11=朱雀改写

Required range: 1 <= x <= 99
Example:

1

Response

改写成功

amount
number<float>
required

本次消费金额(元)

Example:

47.58

code
integer
required

响应状态码,200=成功,500=失败

Example:

200

data
string
required

改写后的文本内容,或错误提示信息

Example:

"人工智能技术是专门研究让计算机系统能够模拟和实现人类智慧行为的学科领域。"

message
string
required

响应消息

Example:

"改写成功"