AI深度原创API接口文档

接口概述

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

接口地址

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

参数列表

文章模型代码

注意此风格列表可能会更新，详情请审查工具箱页面。

请求限制

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

响应说明

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

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

结果回调

文章生成完成后，系统会向您提供的callback URL发送POST请求，传递生成结果。

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

{
    "errno": 2000,
    "err": "生成成功",
    "rsm": {
        "taskid": "custom_task_12345",
        "uwriter_id": 123456,
        "title": "生成的文章标题",
        "result_text": "生成的文章完整内容...",
        "cost": 13,
        "aigc_pic_count": 3 //本次AI配图成功张数
    }
}

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

查询结果

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

查询接口地址

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

查询参数

查询响应

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

处理中：

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

成功：

{
    "errno": 2000,
    "err": "生成成功",
    "rsm": {
        "taskid": "custom_task_12345",
        "uwriter_id": 123456,
        "status": 2,
        "title": "生成的文章标题",
        "result_text": "生成的文章完整内容..."
    }
}

失败：

{
    "errno": 2000,
    "err": "生成失败",
    "rsm": {
        "taskid": "custom_task_12345",
        "uwriter_id": 123456,
        "status": 3,
        "error": "失败原因"
    }
}

查询错误码

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