POST https://saas.api.yoo-ai.com/apps/ppt-createPOSTapplication/json| 参数名 | 类型 | 必填 | 描述 | 示例值 |
|---|---|---|---|---|
Authorization | string | 是 | Authorization - Bearer Token | Bearer Yoo-xxxxxxxxx |
| 参数名 | 类型 | 必填 | 描述 | 默认值 |
|---|---|---|---|---|
font_name | string | 否 | 字体（黑体、宋体、仿宋、幼圆、楷书、隶书） | 黑体 |
cover_id | string | 否 | 模板 ID（通过“AI模板生成方案”接口获取） | - |
language | string | 否 | en-US（英文）、zh-TW（繁体中文） | 简体中文 |
color | string | 否 | PPT 模板主题色（紫色/红色/橙色/黄色/绿色/青色/蓝色/粉色） | 随机 |
user_name | string | 否 | 作者名 | 尤小优 |
ai_picture | bool | 否 | 是否使用 AI 生成图片 | false |
report | bool | 否 | true 表示走编辑器异步渲染，获取任务 ID 后可以直接调用步骤 4 的 PPT 编辑器；启用后，获取结果接口将不会再返回图片数据 | false |
custom_data | object | 是 | 自定义大纲结构，详见下方 custom_data 说明 | - |
custom_data| 参数名 | 类型 | 必填 | 描述 | 默认值 |
|---|---|---|---|---|
title | string | 是 | 标题 | - |
sub_title | string | 否 | 副标题 | - |
author | string | 否 | 作者 | 尤小优 |
catalogs | array | 是 | 大纲，具体见下方 catalogs 说明 | - |
contents | array | 否 | 大纲对应的详细内容；如未传入将由 AI 自动生成，具体见下方 contents 说明 | - |
catalogs| 参数名 | 类型 | 必填 | 描述 | 默认值 |
|---|---|---|---|---|
catalog | string | 是 | 一级大纲 | - |
sub_catalog | array | 否 | 该一级大纲下的二级大纲；可以为空，但建议所有一级大纲保持一致，要么都有、要么都没有二级大纲 | - |
contents若未传入 contents 字段，系统将依据 catalogs 中的大纲自动生成内容。
| 参数名 | 类型 | 必填 | 描述 | 默认值 |
|---|---|---|---|---|
catalog_index | int | 是 | 属于哪个一级大纲，从 0 开始 | - |
sub_catalog_index | int | 是 | 属于一级大纲下的第几个二级大纲，从 0 开始；如果没有二级大纲可传 0 或不传 | - |
content | array(string) / array(object) / string | 是 | 支持 3 种格式：array(string) 会将所有文本换行显示；array(object) 会以图示或 key-value 图文形式展示，key 会高亮；string 直接显示一段文本 | - |
picture | array(string:url) | 否 | 要显示的图片地址，尽量不要超过 3 张 | - |
{
"custom_data": {
"title": "标题",
"sub_title": "副标题",
"author": "作者",
"catalogs": [
{
"catalog": "一级大纲1",
"sub_catalog": ["一级大纲1-二级大纲1"]
},
{
"catalog": "一级大纲2",
"sub_catalog": ["一级大纲2-二级大纲1"]
}
],
"contents": [
{
"catalog_index": 0,
"sub_catalog_index": 0,
"content": ["一级大纲1-二级大纲1-内容1", "一级大纲1-二级大纲1-内容2"]
},
{
"catalog_index": 1,
"sub_catalog_index": 0,
"content": [
{
"key": "一级大纲2-二级大纲1-小标题1",
"value": "一级大纲2-二级大纲1-子内容1"
},
{
"key": "一级大纲2-二级大纲1-小标题2",
"value": "一级大纲2-二级大纲1-子内容2"
},
{
"key": "一级大纲2-二级大纲1-小标题3",
"value": "一级大纲2-二级大纲1-子内容3"
}
]
}
]
},
"font_name": "黑体",
"language": "en-US",
"color": "蓝色",
"user_name": "张三"
}{
"custom_data": {
"title": "父亲节营销活动规划案",
"sub_title": "Father's Day Marketing Activity Plan",
"author": "Launini",
"catalogs": [
{
"catalog": "社会责任与品牌形象",
"sub_catalog": ["公益慈善活动"]
},
{
"catalog": "营销活动策划",
"sub_catalog": ["活动主题与定位"]
}
],
"contents": [
{
"catalog_index": 0,
"sub_catalog_index": 0,
"content": [
"通过父亲节策划的公益慈善活动，公司形象显著提升，社会认可度提高20%，增强了品牌形象。",
"积极履行社会责任，父亲节公益活动引发公众共鸣，品牌影响力扩大30%，树立了正面形象。"
]
},
{
"catalog_index": 1,
"sub_catalog_index": 0,
"content": [
{
"key": "明确活动目标受众",
"value": "父亲节营销活动需针对25-45：岁的主力消费群体，以父爱为主题，吸引家庭消费者。"
},
{
"key": "围绕家庭亲情定位",
"value": "活动主题定位在“家的温馨，父爱如山”，强调家庭情感，符合节日核心价值，提升品牌形象。"
},
{
"key": "定位核心消费群体",
"value": "父亲节营销主要针对25-45：岁成家立业的男性群体，通过数据分析确定核心消费者，精准营销。"
}
]
}
]
},
"font_name": "黑体",
"language": "en-US",
"color": "蓝色",
"user_name": "张三"
}| 参数名 | 类型 | 描述 |
|---|---|---|
code | integer | 状态码 |
msg | string | 响应消息 |
data | object | 数据体 |
data.id | string | 任务 ID |
{
"code": 200,
"msg": "success",
"data": {
"id": "KfvKk2ffTNPjCv8uttV7Bqe3DGAMnMVz"
}
}report=true，获取任务 ID 后可以直接调用打开编辑器接口进入生成渲染页面report=true 后，获取结果接口将不再返回图片数据