# 得到模版列表

## OpenAPI Specification

```yaml
openapi: 3.0.1
info:
  title: ''
  description: ''
  version: 1.0.0
paths:
  /v1/template/list:
    post:
      summary: 得到模版列表
      deprecated: false
      description: |2+


          生成PPT时,需要用到该请求的返回列表中的 模板id:`template_id`

          每个模板的详细情况, 请到**官网**:[www.mindshow.vip](https://www.mindshow.vip/workstation "官网") 查看



      tags:
        - 模板相关
      parameters: []
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                type:
                  description: '分类: private: 私有模板, public: 公共模板,  share: 分享模板.  '
                  default: public
                  examples:
                    - public
                  type: string
                color:
                  description: '颜色分类 '
                  default: 0
                  examples:
                    - 0
                  type: integer
                scene:
                  description: '场景分类 '
                  default: 0
                  examples:
                    - 0
                  type: integer
                query_text:
                  description: '关键字查询 '
                  default: ''
                  type: string
                after:
                  description: '第一页请求无需设置, 后续页的请求使用上页返回 ''after''值   '
                  default: ''
                  type: string
                limit:
                  description: '每页的条数, 默认10条  '
                  default: 10
                  type: integer
                recommend_content:
                  description: '优先输出推荐的模版 '
                  default: ''
                  examples:
                    - 大语言模型发展史
                  type: string
                preview_img_width:
                  description: '指定预览图片的宽度,(px) '
                  default: 0
                  type: integer
                preview_img_quality:
                  description: '指定预览图片的质量,(10-90) '
                  default: 0
                  type: integer
              x-apifox-orders:
                - type
                - color
                - scene
                - query_text
                - after
                - limit
                - recommend_content
                - preview_img_width
                - preview_img_quality
            examples:
              '1':
                value:
                  type: public
                  color: 0
                  scene: 0
                  query_text: ''
                  after: ''
                  limit: 10
                  recommend_content: 大语言模型发展史
                summary: 示例 1
              '2':
                value:
                  type: public
                  after: ''
                  limit: 10
                summary: 示例 2
      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:
                      list:
                        type: array
                        description: 模板列表
                        items:
                          description: ''
                          type: object
                          properties:
                            template_id:
                              description: '模板id '
                              examples:
                                - 138dlkafalk348ff
                              type: string
                            title:
                              description: '标题 '
                              examples:
                                - 模板标题1
                              type: string
                            from_type:
                              description: '来源： `recommend`: 推荐， `default`:默认'
                              type: string
                            type:
                              description: '分类: private: 私有模板, public: 公共模板, share: 分享模板 '
                              examples:
                                - public
                              type: string
                            vip_flag:
                              description: '是否需要会员才能使用 '
                              examples:
                                - false
                              type: boolean
                            preview_img_list:
                              type: array
                              description: 预览图片列表
                              items:
                                description: ''
                                type: string
                          required:
                            - template_id
                            - title
                            - from_type
                            - type
                            - vip_flag
                            - preview_img_list
                          x-apifox-orders:
                            - template_id
                            - title
                            - from_type
                            - type
                            - vip_flag
                            - preview_img_list
                      after:
                        description: 是否有更多数据, 如果不为空, 可以请用该值请求下一页
                        type: string
                    required:
                      - list
                      - after
                    description: 数据区
                    x-apifox-orders:
                      - list
                      - after
                required:
                  - code
                  - info
                  - request_id
                x-apifox-orders:
                  - code
                  - info
                  - request_id
                  - data
          headers: {}
          x-apifox-name: 成功
      security:
        - bearer: []
      x-apifox-folder: 模板相关
      x-apifox-status: released
      x-run-in-apifox: https://app.apifox.com/web/project/3930068/apis/api-142995383-run
components:
  schemas: {}
  securitySchemes:
    bearer:
      type: http
      scheme: bearer
servers:
  - url: https://api.mindshow.vip
    description: 正式环境
security:
  - bearer: []

```
