Dify.ai自定义工具 - pdf转图片

openapi: 3.1.0
info:
  title: PDF转图片API
  version: 1.0.0
  description: PDF转图片API，官网支持：https://www.pdfai.cn/docs/api/dify.ai.html

servers:
  - url: https://pdf-api.pdfai.cn

paths:
  /v1/pdf/pdf_to_image:
    post:
      tags:
        - PDF转图片
      summary: PDF转图片
      operationId: pdfToImage
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PdfToImageRequest'
      responses:
        '200':
          description: 成功
          content:
            application/json:
              schema:
                type: object
                properties:
                  code:
                    type: integer
                    description: 状态码
                    example: 200
                  data:
                    type: object
                    properties:
                      file_url:
                        type: array
                        description: 转换后的图片URL列表
                        items:
                          type: string
                          example: "https://static.pdfai.cn/static/example/out/splitImage_1.png"
                  code_msg:
                    type: string
                    description: 状态信息
                    example: "成功"
                required:
                  - code
                  - data
                  - code_msg
        '500':
          description: 失败
          content:
            application/json:
              schema:
                type: object
                properties:
                  code:
                    type: integer
                    description: 状态码
                    example: 500
                  data:
                    type: object
                    description: 空对象
                    example: {}
                  code_msg:
                    type: string
                    description: 错误信息
                    example: "处理失败: 文件下载失败"
                required:
                  - code
                  - data
                  - code_msg

components:
  schemas:
    PdfToImageRequest:
      type: object
      required:
        - app_key
        - input
      properties:
        app_key:
          type: string
          description: 应用密钥，默认 app_key_dify
          default: app_key_dify   # 声明默认值
          example: app_key_dify   # 示例值保持同步
        input:
          type: string
          format: uri
          description: 远程文件地址，支撑格式PDF，需要远程访问权限，内网不支持。
          example: "https://static.pdfai.cn/static/example/files/four_pages.pdf"