# 简短的 QA 分级机

## OpenAPI Specification

```yaml
openapi: 3.0.1
info:
  title: ''
  description: ''
  version: 1.0.0
paths:
  /v1/grader/short-qa-grader:
    post:
      summary: 简短的 QA 分级机
      deprecated: false
      description: |
        此端点需要帐户批准才能访问。请[联系我们](https://smodin.io/contact)获取访问权限。

        根据评分标准对简答题进行评分。

        ### 文字成本

        **字数成本：** 2-7x
        **字数成本说明：**字数由所有文本输入决定。标准 AI 的 API 字数成本为字数的 2 倍，高级 AI 的 API 字数成本为 7 倍。
      tags:
        - 人工智能评分
      parameters:
        - name: documentId
          in: query
          description: ''
          required: true
          schema:
            type: string
        - name: content-type
          in: header
          description: ''
          required: true
          example: application/json
          schema:
            type: string
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                language:
                  type: string
                subject:
                  type: string
                question:
                  type: string
                text:
                  type: string
              required:
                - language
                - question
                - subject
                - text
              x-apifox-orders:
                - language
                - subject
                - question
                - text
            example:
              language: auto
      responses:
        '201':
          description: ''
          content:
            application/json:
              schema:
                type: object
                properties:
                  language:
                    type: string
                  scores:
                    type: array
                    items:
                      type: object
                      properties:
                        type:
                          type: string
                        name:
                          type: string
                        score:
                          type: integer
                        feedback:
                          type: array
                          items:
                            type: object
                            properties:
                              text:
                                type: string
                            x-apifox-orders:
                              - text
                        suggestions:
                          type: array
                          items:
                            type: object
                            properties:
                              text:
                                type: string
                              checked:
                                type: boolean
                            x-apifox-orders:
                              - text
                              - checked
                        version:
                          type: string
                      x-apifox-orders:
                        - type
                        - name
                        - score
                        - feedback
                        - suggestions
                        - version
                  overallPercentage:
                    type: integer
                required:
                  - language
                  - scores
                  - overallPercentage
                x-apifox-orders:
                  - language
                  - scores
                  - overallPercentage
              example:
                language: string
                scores:
                  - type: string
                    name: string
                    score: 0
                    feedback:
                      - text: string
                    suggestions:
                      - text: string
                        checked: true
                    version: string
                overallPercentage: 0
          headers: {}
          x-apifox-name: 成功
        '400':
          description: ''
          content:
            application/json:
              schema:
                type: object
                properties:
                  message:
                    type: string
                  error:
                    type: string
                  statusCode:
                    type: integer
                required:
                  - message
                  - error
                  - statusCode
                x-apifox-orders:
                  - message
                  - error
                  - statusCode
          headers: {}
          x-apifox-name: 请求有误
      security: []
      x-apifox-folder: 人工智能评分
      x-apifox-status: released
      x-run-in-apifox: https://app.apifox.com/web/project/4355615/apis/api-166425090-run
components:
  schemas: {}
  securitySchemes: {}
servers:
  - url: http://dev-cn.your-api-server.com
    description: 开发环境
  - url: http://test-cn.your-api-server.com
    description: 测试环境
  - url: https://api.smodin.io
    description: 正式环境
security: []

```
