有一云AI OpenAPI 使用帮助

当前仅开放了公众号相关的个别API，后续将会陆续开放更多场景；

场景一、智能写作 + 排版 + 发布业务流程

1. /token：获取并保存 AccessToken（有效期 30 分钟，自行保存）

2. /post/create：根据提示词，生成排版好的文章

3. /post/task/query：根据 TaskID 查询文章，获取文章 PostID，因创作、配图均有一定的时间消耗，建议 2-5 分钟后调用

4. /post/settings/save：如需要自行设置文章封面、作者、摘要等信息，可以对文章属性进行设置，也可以忽略本接口，由系统自动提取

5. /post/mp/sync：同步/发布文章
   

场景二、Markdown + 排版 + 发布业务流程

1. /token：获取并保存 AccessToken（有效期 30 分钟，自行保存）

2. /post/markdown/create：根据提供的 Markdown 原始文本，生成排版好的文章

3. /post/task/query：根据 TaskID 查询文章，获取文章 PostID，因配图有一定的时间消耗，建议 1 分钟后调用

4. /post/settings/save：如需要自行设置文章封面、作者、摘要等信息，可以对文章属性进行设置，也可以忽略本接口，由系统自动提取

5. /post/mp/sync：同步/发布文章
   

获取 API KEY

在用户中心页面，点击 “API KEYS” 菜单，进入 API KEYS 设置界面，点击 “创建 API KEY” 按钮，即可生成接口调用所需的 API KEY。

使用 API KEY 换取 AccessToken

接口地址： https://open.uecloud.com/token
请求方式： POST

注意事项：接口有调用次数限制，建议获取 AccessToken 之后，自行缓存，在必要时再去刷新

入参：

输出结果：

入参示例

{
  api_key: 'xxx',
}

输出示例

{
  "code": 0,
  "data": {
    "access_token": "xxx",
    "expires_in": 1800
  }
}

根据提示词，生成排版好的文章（适用于场景一）

接口地址： https://open.uecloud.com/post/create?access_token={access_token}
请求方式： POST
注意事项：接口有调用频率限制，建议两次调用之间的事件间隔大于 2 分钟

入参：

输出结果：

入参示例

{
  keyword: '新媒体赚钱',
  content_type: 'article',
  model_id: '',
  template_id: 'xxx',
  painting: true,
  thumbs: [
    'https://s.uecloud.com.cn/xxx/xxx.jpg',
    'https://s.uecloud.com.cn/yyy/yyy.jpg'
  ],
  biz_params: {}
}

输出示例

{
  "code": 0,
  "data": {
    "task_id": "DP",
  }
}

根据提供的 Markdown 文本，生成排版好的文章（适用于场景二）

接口地址： https://open.uecloud.com/post/markdown/create?access_token=[Your Access Token]
请求方式： POST
注意事项：接口有调用频率限制，建议两次调用之间的事件间隔大于 2 分钟

入参：

输出结果：

入参示例

{
  markdown: '# 新媒体赚钱\n\n##标题1\n\n内容1\n\n## 标题2\n\n内容2\n\n![美元]()',
  template_id: 'xxx',
  painting: true,
  thumbs: [
    'https://s.uecloud.com.cn/xxx/xxx.jpg',
    'https://s.uecloud.com.cn/yyy/yyy.jpg'
  ],
  biz_params: {}
}

输出示例

{
  "code": 0,
  "data": {
    "task_id": "DP",
  }
}

根据 task_id 查询文章

接口地址： https://open.uecloud.com/post/task/query?access_token={access_token}
请求方式： POST

入参：

输出结果：

入参示例

{
  task_id: 'xxx',
}

输出示例

{
  "code": 0,
  "data": {
    "task_id": "xxx",
    "post_id": "xxx",
    "content_type": "article",
    "biz_params": {},
    "html": "...",
    "status": 9,
    "failed_reason": ""
  }
}

根据 PostID 设置文章属性

接口地址： https://open.uecloud.com/post/settings/save?access_token={access_token}
请求方式： POST
注意事项：仅支持图文消息类型（article），微信笔记（图片/文字）不支持

入参：

输出结果：true | false

入参示例

{
  post_id: 'xxx',
  settings: {
    author: '有一云AI',
    digest: '这里是文章摘要这里是文章摘要',
    thumb: 'https://s.uecloud.com.cn/xxx/xxx.jpg',
    need_open_comment: false,
    only_fans_can_comment: false,
    content_source_url: 'https://www.uecloud.com/'
  }
}

输出示例

{
  "code": 0,
  "data": true
}

将文章发布至公众号（或同步至草稿箱）

接口地址： https://open.uecloud.com/post/mp/sync?access_token={access_token}
请求方式： POST
注意事项：接口有调用频率限制，请勿频繁调用

入参：

输出结果：true | false

入参示例

{
  appid: 'xxx',
  sync_type: 'Draft',
  posts: [{
    post_id: 'xxx',
  }, {
    post_id: 'yyy',
  }]
}

输出示例

{
  "code": 0,
  "data": true
}