Create generation job

POST /generation/jobs

根据提供的内容、文件或提示创建一个生成任务，生成考试题目。

在创建生成任务时，需要通过 creation_type 来声明任务类型，通过 question_rules 来指定生成题目的种类和数量。

creation_type:

knowledge_base 通过资料生成题目
question_bank 格式化本地题库
oneline 无资料情况下，根据需求描述生成题目

如果你已经拥有一个本地题库，它们可能是 Word、Excel 或 PDF 文件，你可以先上传文件，然后创建一个 question_bank 类型的任务。

{ file: 'file-xxxxxx', creation_type: 'question_bank' }

如果你有一份文档资料，它们可能是 Word、PDF 或 PPT 文件，你可以先上传文件，然后创建一个 knowledge_base 类型的任务。

{
  file: 'file-xxxxxx',
  creation_type: 'knowledge_base',
  question_rules: [{ type: 'single_choice', count: 10 }]
}

如果你没有任何资料，你可以直接创建一个 oneline 类型的任务。

{
  prompt: '帮我生成一套反诈知识的试卷',
  creation_type: 'oneline',
  question_rules: [{ type: 'single_choice', count: 10 }]
}

question_rule:

type 题目类型，可选值：
- single_choice 单选题
- multiple_choice 多选题
- true_or_false 判断题
- multiple_blank 填空题
- short_answer 简答题
count 题目数量，合计生成的题目数量最大为 100。

application/json

Body object

无资料情况下，根据需求描述生成题目。

prompt string Required

Maximum length is 256.
creation_type string Required

Value is oneline.
question_rules array[object]

Maximum sum(count) is 100.
Hide question_rules attributes Show question_rules attributes object
- type string Required
  
  Values are single_choice, multiple_choice, true_or_false, multiple_blank, or short_answer.
- count integer Required
metadata object | null

根据提供的文件生成题目。

prompt string

Maximum length is 256.
file string Required

Maximum content length is 128000.

Format should match the following pattern: ^file-.
creation_type string Required

Values are knowledge_base or question_bank.
question_rules array[object]

Maximum sum(count) is 100.
Hide question_rules attributes Show question_rules attributes object
- type string Required
  
  Values are single_choice, multiple_choice, true_or_false, multiple_blank, or short_answer.
- count integer Required
metadata object | null

根据提供的文本内容生成题目。（无需上传文件）

prompt string

Maximum length is 256.
content string Required

Maximum length is 128000.
creation_type string Required

Values are knowledge_base or question_bank.
question_rules array[object]

Maximum sum(count) is 100.
Hide question_rules attributes Show question_rules attributes object
- type string Required
  
  Values are single_choice, multiple_choice, true_or_false, multiple_blank, or short_answer.
- count integer Required
metadata object | null

Responses

201 application/json

generation created
Hide response attributes Show response attributes object
- id string
  
  Format should match the following pattern: ^gen-.
- object string
  
  Value is generation.
- created_at string(date-time)
- finished_at string(date-time) | null
- status string
  
  Values are queued, generating, succeeded, failed, or cancelled.
400 application/json

generation not created

POST /generation/jobs

curl \
 --request POST 'https://api.kuaichuti.net/v1/generation/jobs' \
 --header "Authorization: Bearer $ACCESS_TOKEN" \
 --header "Content-Type: application/json" \
 --data '{"file":"file-xxxxxx","creation_type":"knowledge_base","question_rules":[{"type":"single_choice","count":10}]}'

Request examples

{
  "file": "file-xxxxxx",
  "creation_type": "knowledge_base",
  "question_rules": [
    {
      "type": "single_choice",
      "count": 10
    }
  ]
}

{
  "content": "This is an example content",
  "creation_type": "knowledge_base",
  "question_rules": [
    {
      "type": "single_choice",
      "count": 10
    }
  ]
}

{
  "prompt": "帮我生成一套反诈知识的试卷",
  "creation_type": "oneline",
  "question_rules": [
    {
      "type": "single_choice",
      "count": 10
    }
  ]
}

Response examples (201)

{
  "id": "gen-67d79d01e88e5d4493374963",
  "object": "generation",
  "status": "queued",
  "created_at": "2025-03-17T11:54:41.523+08:00",
  "finished_at": null
}

Response examples (400)

{
  "error": {
    "type": "invalid_request_error",
    "message": "Creation Type can't be blank"
  }
}