智能生成内容获取

接入前提

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

智能生成内容获取用于标题生成 PPT 的主要链路。接入方需要先创建任务，再按“大纲生成 → 内容生成 → 结果查询”的顺序处理。

步骤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"
}

状态处理建议

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