智能生成内容获取

接入前提

获取调用 API 所需的 token 请参考 API 鉴权

标题生成不是单个同步接口。创建任务后，需要依次生成大纲、提交内容生成，再用返回的 ticket 查询结果。

标题生成的三段调用

步骤	接口目标	成功后得到什么
1. 标题生成大纲	根据 taskId 流式生成大纲	可展示或继续生成内容的大纲文本
2. 大纲生成内容	基于大纲发起内容生成任务	ticket 查询凭证
3. 生成内容结果查询	根据 ticket 查询最终内容	可进入大纲数据结构或作品生成的 Markdown 内容

只有步骤 3 返回生成成功状态和完整 content，标题生成才算完成。之后再调用 获取大纲数据结构 或 作品。

步骤1.标题生成大纲

接口行为

接口描述	创建type=1（智能生成）任务并获取任务ID后，调用此接口生成ppt大纲
接口地址	/api/ai/chat/outline	请求方式	GET
权限校验	是	请求参数	json
响应类型	text/event-stream

请求参数

请求示例

curl --location 'https://co.aippt.cn/api/ai/chat/outline?task_id=<taskId>' \
--header 'x-api-key: <apiKey>' \
--header 'x-channel: <channel>' \
--header 'x-token: <token>'

响应内容

响应示例

event:message
data:{"content":"``"}

event:message
data:{"content":"`\n"}

event:message
data:{"content":"#"}

event:message
data:{"content":" 业"}

......

event:message
data:{"content":"```"}

event:close
data:api-close

步骤2.大纲生成内容

步骤 2 返回的是内容生成查询凭证 ticket，不是最终内容。接入方需要保存 ticket，继续调用步骤 3 查询生成结果。

接口行为

接口描述	此接口是用户通过大纲创建生成内容任务，后续通过/api/ai/chat/v2/content/check接口获取任务结果
接口地址	/api/ai/chat/v2/content	请求方式	GET
权限校验	是	请求参数	json
响应类型	text/json

请求参数

请求示例

curl --location 'https://co.aippt.cn/api/ai/chat/v2/content?task_id=<taskId>' \
--header 'x-api-key: <apiKey>' \
--header 'x-channel: <channel>' \
--header 'x-token: <token>'

响应内容

响应示例

{
    "code": 0,
    "data": "ticket", 
    "msg": "ok"
}

步骤2-1.专业布局生成任务

接口行为

接口描述	此接口用于在大纲生成内容任务创建后，根据完整大纲创建专业布局生成任务，返回专业布局任务ID，供后续专业布局生成流程使用。
接口地址	/api/ai/pro/layout/add	请求方式	POST
权限校验	是	请求参数	json
响应类型	text/json

请求参数

请求示例

curl --location 'https://co.aippt.cn/api/ai/pro/layout/add' \
--header 'x-api-key: <apiKey>' \
--header 'x-channel: <channel>' \
--header 'x-token: <token>' \
--header 'Content-Type: application/json' \
--data '{
    "text_id": ${task_id}
}'

响应内容

响应示例

{
    "code": 0,
    "data": {
        "id": 123
    },
    "msg": "ok"
}

步骤3.生成内容结果查询

轮询结果

接口描述	此接口是获取生成内容任务的结果，通过/api/ai/chat/v2/content接口响应的数据作为ticket获取任务状态和内容结果。 需要轮询进行调用。
接口地址	/api/ai/chat/v2/content/check	请求方式	GET
权限校验	是	请求参数	json
响应类型	text/json

请求参数

请求示例

curl --location 'https://co.aippt.cn/api/ai/chat/v2/content/check?ticket=<ticket>' \
--header 'x-api-key: <apiKey>' \
--header 'x-channel: <channel>' \
--header 'x-token: <token>'

响应内容

响应示例

{
    "code": 0,
    "data": {
        "status": 2,
        "content": "```\n# 探索数字12的奥秘\r\n## 1. 数字12的起源与文化背景\n### 1.1 数字12的历史渊源\n#### 1.1.1 古代文明的数字12\n- 在古代文明中，数字12具有特殊的意义。例如，古巴比伦人将一年分为12个月，这与他们使用的黄道带有12个星座相吻合。古埃及人也使用12作为他们的时间单位，将其分为12个时辰。这些古代文明的选择影响了后世对数字12的使用和理解。\n\n#### 1.1.2 数字12在宗教中的地位\n- 在宗教中，数字12常常代表着神圣和完整。例如，在基督教中，《圣经》提到了12使徒和12个门徒，这象征着教会的完整性和宇宙的秩序。在伊斯兰教中，12也是重要的数字，代表着12位伊玛目，他们是什叶派信仰中的精神领袖。\n\n#### 1.1.3 数字12在神话传说中的角色\n- 在许多神话传说中，数字12扮演着重要角色。如希腊神话中的12位奥林匹克神，他们掌管着自然界和人类生活的各个方面。中国神话中的12生肖，代表着12年的循环，每个生肖都有其独特的象征意义。\n\n#### 1.1.4 数字12在现代文化中的影响\n- 现代文化中，数字12仍然具有重要地位。例如，12个月构成一年，12小时构成一天（分为上午和下午），12个音符构成一个八度音阶。此外，许多国家的法律、体育比赛规则和度量衡系统也以12为基数。\n\n```"
    },
    "msg": "success"
}

状态处理

状态	建议处理
生成中	继续按业务节奏查询结果，避免高频轮询
生成成功	使用返回内容进入大纲数据结构或作品生成
生成失败	回到对应生成步骤重新提交，不要继续使用失败的中间结果