AI深度改写API接口文档

接口概述

本接口提供AI文本深度改写服务，采用异步处理模式。用户提交改写任务后，系统会返回任务ID。改写完成后可通过回调URL接收结果，也可使用查询接口主动拉取结果。

接口地址

POST https://www.ucaiyun.com/console/apis/ai_rewriter/
Content-Type: application/json
User-Agent: 请设置正常浏览器UA

参数列表

请求限制

频率限制：同一apikey间隔至少0.5秒

响应说明

如果提交成功，系统响应如下：

{
    "errno": 2000,
    "err": "任务已创建，请等待回调结果",
    "rsm": {
        "taskid": "custom_task_12345",
        "rewriter_id": 123456
    }
}

结果回调

改写任务完成后，系统会向您提供的callback URL发送POST请求，传递改写结果。

请求方法: POST，Content-Type: application/x-www-form-urlencoded，等待响应时间: 30秒

{
    "errno": 2000,
    "err": "改写成功",
    "rsm": {
        "taskid": "custom_task_12345",
        "rewriter_id": 123456,
        "result_text": "改写后的完整文本内容...",
        "cost": 10 //消耗的积分（按改写后字数，示例为VIP约10积分/千字）
    }
}

如果回调失败（非200状态码），系统会自动重试，最多重试3次。请注意根据taskid去重。回调未收到时，可用下方查询接口按 rewriter_id 拉取结果。

查询结果

任务提交后除等待回调外，也可主动查询改写结果。查询不消耗积分，须使用创建任务时返回的 rewriter_id，不支持用自定义 taskid 查询。

查询接口地址

POST https://www.ucaiyun.com/console/apis/get_ai_rewriter/
Content-Type: application/json
User-Agent: 请设置正常浏览器UA

查询参数

查询响应

status 取值：0 等待执行，1 生成中，10 处理中，2 改写成功，3 改写失败。只有 status=2 时才返回 result_text。

处理中：

{
    "errno": 2000,
    "err": "生成中",
    "rsm": {
        "taskid": "custom_task_12345",
        "rewriter_id": 123456,
        "status": 1
    }
}

成功：

{
    "errno": 2000,
    "err": "改写成功",
    "rsm": {
        "taskid": "custom_task_12345",
        "rewriter_id": 123456,
        "status": 2,
        "result_text": "改写后的完整文本内容..."
    }
}

失败：

{
    "errno": 2000,
    "err": "改写失败",
    "rsm": {
        "taskid": "custom_task_12345",
        "rewriter_id": 123456,
        "status": 3,
        "error": "失败原因"
    }
}

查询错误码

查询接口频率限制：同一apikey间隔至少5秒。