# 通过标题生成PPT大纲

## OpenAPI Specification

```yaml
openapi: 3.0.1
info:
  title: ''
  description: ''
  version: 1.0.0
paths:
  /v1/gpt/gen_outline_by_topic:
    post:
      summary: 通过标题生成PPT大纲
      deprecated: false
      description: |2+

          输出PPT大纲
          :::caution
          该请求推荐使用流式输出(参数： stream=true)
          请参考 [gpt流式接口调用介绍](https://api-doc.mindshow.vip/doc-6480736.md)
          :::

          :::caution
          消耗积分规则： 每次扣除1个积分
          :::





      tags:
        - 大语言GPT
      parameters: []
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                topic:
                  description: '要生成的主题 '
                  default: ''
                  examples:
                    - 大语言模型发展历程
                  type: string
                stream:
                  description: '是否流式输出 '
                  default: false
                  examples:
                    - ''
                  type: boolean
                model:
                  description: '使用模型. `ali` :阿里，`deepseek`: "Deepseek" ,  '
                  default: ali
                  type: string
                page_count:
                  description: '建议生成的页面个数  '
                  default: 0
                  examples:
                    - '15'
                  type: integer
                language:
                  description: >-
                    分类: `zh`: 简体中文, `zh_hant`: 繁体中文,  `en`: 英文, `jp`: 日文,
                    `kr`:韩文.   
                  default: zh
                  examples:
                    - ''
                  type: string
                scene:
                  description: '在什么样场景下使用, 如：`分析报告`， `教学课件`, `产品介绍`, `公众演讲`, `财务分析` ...  '
                  default: ''
                  examples:
                    - ''
                  type: string
                target_audience:
                  description: '目标受众, 如：`学生`， `大众`, `员工`  ...  '
                  default: ''
                  examples:
                    - ''
                  type: string
                desc_info:
                  description: '备注，关于该主题的更多说明,或用户对话内容 '
                  default: ''
                  examples:
                    - ''
                  type: string
                qa_list:
                  type: array
                  description: '问答列表  '
                  items:
                    description: ''
                    default:
                      question: ''
                      answer: ''
                    type: object
                    properties:
                      question:
                        description: 问题
                        type: string
                      answer:
                        description: 回答
                        type: string
                    required:
                      - question
                      - answer
                    x-apifox-orders:
                      - question
                      - answer
                resource_id_list:
                  type: array
                  description: '参考的文件id列表:["xxxx1","xxxx2"], '
                  items:
                    description: ''
                    default: xxxx
                    examples:
                      - xxxxxxxx
                    type: string
              x-apifox-orders:
                - topic
                - stream
                - model
                - page_count
                - language
                - scene
                - target_audience
                - desc_info
                - qa_list
                - resource_id_list
      responses:
        '200':
          description: 成功
          content:
            application/json:
              schema:
                type: object
                title: ResponseModel
                properties:
                  code:
                    type: integer
                    description: 错误码( 0:成功. 其它值:失败[无data数据区])
                  info:
                    type: string
                    description: 错误信息
                    examples:
                      - succ
                  request_id:
                    type: string
                    description: 请求id,用于定位请求
                    examples:
                      - 21al1389334aal4f
                  data:
                    type: object
                    properties:
                      content:
                        description: 输出内容
                        type: string
                      content_ex_info:
                        description: 内容扩展信息,用于后续操作 ,在stop 时才有值
                        type: string
                      all_content:
                        description: 全量的输出内容. stream=true ,在stop 时才有值
                        type: string
                      finish_reason:
                        description: >-
                          "stop":正常结束, null: 流式输出过程, "topic_invalid" :
                          主题无效无法生成大纲 , "content_inappropriate" : 出现敏感内容中断,
                          "system_error" : 系统异常,
                          topic_or_resource_id_list_invalid: 需要主题或文件资源
                        type: string
                    required:
                      - content
                      - content_ex_info
                      - all_content
                      - finish_reason
                    description: 数据区
                    x-apifox-orders:
                      - content
                      - content_ex_info
                      - all_content
                      - finish_reason
                required:
                  - code
                  - info
                  - request_id
                x-apifox-orders:
                  - code
                  - info
                  - request_id
                  - data
          headers: {}
          x-apifox-name: 成功
      security:
        - bearer: []
      x-apifox-folder: 大语言GPT
      x-apifox-status: released
      x-run-in-apifox: https://app.apifox.com/web/project/3930068/apis/api-285578187-run
components:
  schemas: {}
  securitySchemes:
    bearer:
      type: http
      scheme: bearer
servers:
  - url: https://api.mindshow.vip
    description: 正式环境
security:
  - bearer: []

```