# 创建任务:[非AI]通过MarkDown大纲生成PPT

## OpenAPI Specification

```yaml
openapi: 3.0.1
info:
  title: ''
  description: ''
  version: 1.0.0
paths:
  /v1/job/ppt_create_by_markdown:
    post:
      summary: 创建任务:[非AI]通过MarkDown大纲生成PPT
      deprecated: false
      description: >+


        :::caution


        生成PPT是 **异步任务**


        该请求会生成异步任务, 并返回任务id ,此时的 `ppt_url` 为空



        生成时间预计: **10-20秒**


        需要 后续轮询调用 **获取单个任务数据** `/v1/job/get` 协议获取任务的最新状态 (推荐每隔5秒请求一次,直到任务成功)


        :::


        :::caution

        消耗积分规则： 每次扣除10个积分

        :::






        markdown 3级格式如下:

        ```markdown

        #  主标题


        ##  1级


        ###  2级

        ####  3级

        3级描述

        ####  3级

        3级描述


        ```

        案例如下:

        ```markdown

        # 中国传统文化艺术之美


        ## 介绍中国传统文化艺术的丰富内涵和影响


        ### 传统文化的重要性和价值

        #### 传承千年的文化宝藏

        中国传统文化是一座千年的宝藏，蕴含着丰富的哲学思想、价值观念和审美情趣。这些传统元素是中华民族独特的文化基因，凝聚了历史的智慧和精髓。


        #### 对现代社会的启示和影响

        传统文化在现代社会依然具有重要的启示意义。通过对古人的智慧进行深入思考，我们可以找到应对现实问题的新路径。传统文化也是塑造社会共识、凝聚国家认同感的重要纽带。


        ## 中国传统绘画艺术的魅力


        ### 国画的独特韵味

        #### 水墨意境的表达

        水墨意境是国画的灵魂，通过线条、墨色、留白等表现情感与意境。画家在作品中运用“有形无形”的艺术手法，勾勒出深远的意境，引导观者自由想象。


        #### 山水、花鸟、人物画的特点

        国传统绘画包括山水、花鸟、人物等多种题材。山水画以“山呼万壑赴碧空”表现大自然壮美，花鸟画以“梅兰竹菊”传递深意，人物画以“以形写神”展现人物性格。


        ### 工笔与写意的艺术表现

        #### 工笔画的精细技法

        工笔画追求精细写实，要求线条准确、细腻，色彩鲜艳。画家通过层层叠加的颜色和细节描绘，创造出生动逼真的画面，令人陶醉其中。


        #### 写意画的意境与自由

        写意画强调意境与表现力，画家以自由的笔墨表现内心情感。通过墨点、墨痕、笔法的变化，创造出富有情感和个性的艺术效果，令人感受到画家的创作情趣。


        ### 画家与作品赏析

        #### 吴道子的人物风貌

        吴道子以深刻的人物刻画而著称。他通过精湛的线条和丰富的神态表现，勾勒出生动立体的人物形象，展现了人物的性格和情感。


        #### 张大千的山水传奇

        张大千是一位跨界艺术家，他的山水画作品充满浪漫主义气息。他通过丰富的色彩和大胆的构图，创造出独特的山水意境，赋予作品深厚的情感内涵。

        ```

        请求案例:

        ```json

        {

        "template_id": "xxxxxxxx",

        "speaker": "演讲者名称",

        "content": "# 中国传统文化艺术之美\n\n## 介绍中国传统文化艺术的丰富内涵和影响\n\n###
        传统文化的重要性和价值\n####
        传承千年的文化宝藏\n中国传统文化是一座千年的宝藏，蕴含着丰富的哲学思想、价值观念和审美情趣。这些传统元素是中华民族独特的文化基因，凝聚了历史的智慧和精髓。\n\n####
        对现代社会的启示和影响\n传统文化在现代社会依然具有重要的启示意义。通过对古人的智慧进行深入思考，我们可以找到应对现实问题的新路径。传统文化也是塑造社会共识、凝聚国家认同感的重要纽带。\n\n##
        中国传统绘画艺术的魅力\n\n### 国画的独特韵味\n####
        水墨意境的表达\n水墨意境是国画的灵魂，通过线条、墨色、留白等表现情感与意境。画家在作品中运用“有形无形”的艺术手法，勾勒出深远的意境，引导观者自由想象。\n\n####
        山水、花鸟、人物画的特点\n国传统绘画包括山水、花鸟、人物等多种题材。山水画以“山呼万壑赴碧空”表现大自然壮美，花鸟画以“梅兰竹菊”传递深意，人物画以“以形写神”展现人物性格。\n\n###
        工笔与写意的艺术表现\n####
        工笔画的精细技法\n工笔画追求精细写实，要求线条准确、细腻，色彩鲜艳。画家通过层层叠加的颜色和细节描绘，创造出生动逼真的画面，令人陶醉其中。\n\n####
        写意画的意境与自由\n写意画强调意境与表现力，画家以自由的笔墨表现内心情感。通过墨点、墨痕、笔法的变化，创造出富有情感和个性的艺术效果，令人感受到画家的创作情趣。\n\n###
        画家与作品赏析\n####
        吴道子的人物风貌\n吴道子以深刻的人物刻画而著称。他通过精湛的线条和丰富的神态表现，勾勒出生动立体的人物形象，展现了人物的性格和情感。\n\n####
        张大千的山水传奇\n张大千是一位跨界艺术家，他的山水画作品充满浪漫主义气息。他通过丰富的色彩和大胆的构图，创造出独特的山水意境，赋予作品深厚的情感内涵。\n\n"

        }

        ```

      tags:
        - PPT生成
      parameters: []
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                template_id:
                  description: '模板id, 默认使用智能匹配的模版   '
                  default: ''
                  examples:
                    - 1xxxxxxxxx
                  type: string
                speaker:
                  description: '演讲者 '
                  examples:
                    - 演讲者名称
                  type: string
                content:
                  description: '3级 markdown 内容   '
                  examples:
                    - >
                      # 中国传统文化艺术之美


                      ## 介绍中国传统文化艺术的丰富内涵和影响


                      ### 传统文化的重要性和价值

                      #### 传承千年的文化宝藏

                      中国传统文化是一座千年的宝藏，蕴含着丰富的哲学思想、价值观念和审美情趣。这些传统元素是中华民族独特的文化基因，凝聚了历史的智慧和精髓。


                      #### 对现代社会的启示和影响

                      传统文化在现代社会依然具有重要的启示意义。通过对古人的智慧进行深入思考，我们可以找到应对现实问题的新路径。传统文化也是塑造社会共识、凝聚国家认同感的重要纽带。


                      ## 中国传统绘画艺术的魅力


                      ### 国画的独特韵味

                      #### 水墨意境的表达

                      水墨意境是国画的灵魂，通过线条、墨色、留白等表现情感与意境。画家在作品中运用“有形无形”的艺术手法，勾勒出深远的意境，引导观者自由想象。


                      #### 山水、花鸟、人物画的特点

                      国传统绘画包括山水、花鸟、人物等多种题材。山水画以“山呼万壑赴碧空”表现大自然壮美，花鸟画以“梅兰竹菊”传递深意，人物画以“以形写神”展现人物性格。


                      ### 工笔与写意的艺术表现

                      #### 工笔画的精细技法

                      工笔画追求精细写实，要求线条准确、细腻，色彩鲜艳。画家通过层层叠加的颜色和细节描绘，创造出生动逼真的画面，令人陶醉其中。


                      #### 写意画的意境与自由

                      写意画强调意境与表现力，画家以自由的笔墨表现内心情感。通过墨点、墨痕、笔法的变化，创造出富有情感和个性的艺术效果，令人感受到画家的创作情趣。


                      ### 画家与作品赏析

                      #### 吴道子的人物风貌

                      吴道子以深刻的人物刻画而著称。他通过精湛的线条和丰富的神态表现，勾勒出生动立体的人物形象，展现了人物的性格和情感。


                      #### 张大千的山水传奇

                      张大千是一位跨界艺术家，他的山水画作品充满浪漫主义气息。他通过丰富的色彩和大胆的构图，创造出独特的山水意境，赋予作品深厚的情感内涵。
                  type: string
                create_preview_image_type:
                  description: >-
                    创建预览图.（会减慢生成速度!）   `null` :无需生成，`title`: "标题页" ,  `top3`
                    :"前3张" ,   
                  default: 'null'
                  type: string
                create_ppt_flag:
                  description: '是否生成ppt,  '
                  default: true
                  type: boolean
                use_img_mode:
                  description: '使用图片模式:  `default`: 自身图片 +系统推荐图片    ,   `self`:尽量只用自身图片, '
                  default: default
                  type: string
                aigc_implicit_label:
                  description: '合规性要求( 互联网安全-人工智能合成内容表示的 JSON) 内容:    '
                  default: >-
                    {"Label":"Mindshow","ContentProducer":"Mindshow
                    API","ProduceID":"Mindshow","ReservedCode1":"0","ContentPropagator":"0","PropagateID":"0","ReservedCode2":"1"}
                  type: string
              required:
                - speaker
                - content
              x-apifox-orders:
                - template_id
                - speaker
                - content
                - create_preview_image_type
                - create_ppt_flag
                - use_img_mode
                - aigc_implicit_label
      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:
                      job:
                        description: 任务消息
                        type: object
                        properties:
                          id:
                            description: '任务id  '
                            examples:
                              - 1dk13k3hgfk
                            type: string
                          title:
                            description: '标题 '
                            examples:
                              - 标题
                            type: string
                          status:
                            description: >-
                              状态 [ `queued`:排队中, `running`:进行中 , 
                              `succeeded`:完成, `failed`:失败  ]  
                            examples:
                              - succeeded
                            type: string
                          queue_wait_count:
                            description: 队列等待个数.
                            type: integer
                          progress_percent:
                            description: '进度: 0-100 , status=`running` 有效 '
                            examples:
                              - 0
                            type: integer
                          created_at:
                            description: '任务创建时间 '
                            examples:
                              - '2020-01-01T00:00:00+08:00'
                            type: string
                          finished_at:
                            description: '任务完成时间 '
                            examples:
                              - '2020-01-01T00:00:00+08:00'
                            type: string
                          ppt_url:
                            description: >-
                              生成ppt 对应的url, 注意：该链接带签名需要完整的链接才能下载,
                              `有效时间为一周,请及时下载到本地`
                            type: string
                          template_id:
                            description: (任务：生成模版才有值) 生成的模版ID, 可用用于后续生成PPT
                            type: string
                          preview_img_list:
                            type: array
                            description: PPT前3张预览图的图片列表, `有效时间为一周,请及时下载到本地`
                            items:
                              description: ''
                              type: string
                          error:
                            description: 任务错误情况下的报错信息
                            type: string
                        required:
                          - id
                          - title
                          - status
                          - queue_wait_count
                          - progress_percent
                          - created_at
                          - finished_at
                          - ppt_url
                          - template_id
                          - preview_img_list
                          - error
                        x-apifox-orders:
                          - id
                          - title
                          - status
                          - queue_wait_count
                          - progress_percent
                          - created_at
                          - finished_at
                          - ppt_url
                          - template_id
                          - preview_img_list
                          - error
                    required:
                      - job
                    description: 数据区
                    x-apifox-orders:
                      - job
                required:
                  - code
                  - info
                  - request_id
                x-apifox-orders:
                  - code
                  - info
                  - request_id
                  - data
          headers: {}
          x-apifox-name: 成功
      security:
        - bearer: []
      x-apifox-folder: PPT生成
      x-apifox-status: released
      x-run-in-apifox: https://app.apifox.com/web/project/3930068/apis/api-319907051-run
components:
  schemas: {}
  securitySchemes:
    bearer:
      type: http
      scheme: bearer
servers:
  - url: https://api.mindshow.vip
    description: 正式环境
security:
  - bearer: []

```
