AI 문제 생성
지식/학습 서비스 중텍스트 내용을 분석하여 난이도와 유형에 맞는 인공지능 예상 문제를 자동으로 생성합니다.
API 키 필수
HTTPS
POST
/api/v1/quiz/generate
API 설명
AI 문제 생성 API는 교육 전문가 수준의 문제 출제 능력을 갖춘 AI 모델을 통해, 입력된 텍스트의 핵심 개념을 도출하고 이를 기반으로 평가 문항을 생성합니다.
- 객관식(4지선다) 및 주관식 유형 지원
- 상, 중, 하 3단계 난이도 설정 가능
- 문제별 정답 및 상세 해설 자동 생성
- 교육, 리서치, 자격증 대비 콘텐츠 제작에 최적화
사용 가이드
## 사용 방법
### 요청
```http
POST /api/v1/quiz/generate
Content-Type: application/json
X-API-Key: YOUR_API_KEY
```
### 요청 파라미터
| 필드명 | 타입 | 필수 | 설명 |
| :--- | :---: | :---: | :--- |
| text | String | Y | 분석할 원문 텍스트 (최대 5,000자) |
| difficulty | String | N | 난이도 (easy, medium, hard / 기본 medium) |
| quiz_type | String | N | 문제 유형 (multiple: 객관식, short: 주관식 / 기본 multiple) |
| count | Integer | N | 생성할 문제 수 (1~5 / 기본 3) |
### 응답 파라미터
| 필드명 | 타입 | 설명 |
| :--- | :---: | :--- |
| success | Boolean | API 호출 성공 여부 |
| quizzes | Array | 생성된 문제 리스트. 하위 항목은 다음과 같습니다: |
| - question | String | 생성된 문제의 질문 내용 |
| - options | Array | 객관식 보기 리스트 (주관식인 경우 빈 배열) |
| - answer | String | 정답 (객관식: 1~4 번호, 주관식: 정답 단어/문장) |
| - explanation | String | 해당 문제에 대한 정답 이유 및 추가 해설 |
| api | String | 호출된 API 슬러그 (`quiz-generation`) |
| remaining | Integer | 잔여 호출 가능 횟수 |
### 오류 코드
| 코드 | 메시지 | 원인 및 해결 방법 |
| :--- | :--- | :--- |
| **400** | 문제를 생성할 원본 텍스트를 입력해주세요. | `text` 파라미터가 비어있습니다. |
| **401** | 유효하지 않은 API 키입니다. | API 키가 누락되었거나 틀렸습니다. |
| **429** | 사용 가능 횟수를 모두 소진하였습니다. | 할당된 무료 호출 횟수를 초과했습니다. |
| **500** | 문제 생성 중 서버 오류 발생 | AI 엔진 통신 중 일시적인 오류입니다. |
공통 인증 헤더
X-API-Key: YOUR_API_KEY
Content-Type: application/jsoncURL 예제
curl -X POST https://engines.ai.kr/api/v1/quiz/generate \
-H "X-API-Key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"text":"..."}'