daglo API 가이드

Korean

English

Korean

English

Appearance

회의록 요약하기 ​

1. 소개 ​

Minutes API는 회의록을 자동으로 작성해주는 서비스입니다. 이 API는 회의 내용이나 대화를 텍스트로 제공받아 이를 요약하고 중요한 포인트를 자동으로 정리하여 회의록을 생성합니다.

주요 기능 ​

  • 회의록 생성: 입력된 텍스트를 기반으로 회의록을 자동으로 생성합니다.
  • 사용자 정의 데이터: 요청 시 사용자 정의 데이터를 포함시켜 응답받을 수 있습니다.
  • 비동기 처리: 요청을 비동기 방식으로 처리하여 대량의 회의록 생성 작업을 효율적으로 처리할 수 있습니다.
  • 콜백 지원: 작업이 완료되면 지정된 URL로 결과를 콜백 받을 수 있습니다.

왜 사용해야 하나요? ​

Minutes API를 사용하면 회의 내용을 빠르고 정확하게 요약하여 회의록을 작성할 수 있습니다. 이를 통해 회의록 작성 시간을 절약하고, 중요한 내용을 놓치지 않도록 도와줍니다.

  • 회의록 자동 작성 시스템: 회의 내용을 입력하면 자동으로 요약된 회의록을 생성하여 배포할 수 있습니다.
  • 대화 요약 서비스: 긴 대화를 요약하여 중요한 포인트만 정리한 문서를 생성할 수 있습니다.
  • 비즈니스 리포트: 회의 내용을 기반으로 간단한 비즈니스 리포트를 작성할 수 있습니다.

2. 예제 ​

아래는 간단한 사용 예제입니다. 이 예제에서는 긴 텍스트를 API에 전송하고, API는 해당 텍스트를 요약하여 회의록을 생성합니다.

1)요청 및 요청 응답 POST ​

  • 회의록을 생성할 본문을 담아 요청을 보내고 응답을 받습니다.

Request Sample

shell
curl -X POST 'https://apis.daglo.ai/nlp/v1/async/minutes' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer <API_TOKEN>' \
--data '{ "text": "<TEXT>"}'

Response Sample

json
{ "rid": "<RID>" }

2)결과 응답 GET ​

  • 요청한 회의록의 결과를 GET 방식으로 진행 과정과 결과를 받아볼 수 있습니다.

Request Sample

shell
curl 'https://apis.daglo.ai/nlp/v1/async/minutes/<RID>' \
--header 'Authorization: Bearer <API_TOKEN>'

Response Sample

json
{
    "rid": "<RID>",
    "status": "processed",
    "progress": 100,
    "title": "전체 제목",
    "minutes": [
        {
            "bullets": [
                {
                    "isImportant": false,
                    "text": "summary 1"
                },
                {
                    "isImportant": false,
                    "text": "summary 2"
                },
                {
                    "isImportant": true,
                    "text": "summary 3"
                },
                {
                    "isImportant": false,
                    "text": "summary 4"
                },
                {
                    "isImportant": false,
                    "text": "summary 5"
                }
            ],
            "title": "소제목 1"
        },
        {
            "bullets": [
                {
                    "isImportant": false,
                    "text": "summary 1"
                },
                {
                    "isImportant": false,
                    "text": "summary 2"
                },
                {
                    "isImportant": false,
                    "text": "summary 3"
                },
                {
                    "isImportant": false,
                    "text": "summary 4"
                },
                {
                    "isImportant": false,
                    "text": "summary 5"
                }
            ],
            "title": "소제목 2"
        }
    ]
}

3) 결과 응답 Callback ​

  • POST에서 Callback URL을 명시한 경우, 해당 경로로 요약 결과를 전송받습니다.
  • 자세한 내용은 Get(Polling)과 Callback 문서를 확인해주세요.

3. 사용법 ​

1) API Key 발급하기 ​

text
- API 콘솔에 접속하여 회원가입 후 로그인합니다.
- 토큰 메뉴에 들어가 새로운 토큰을 발급합니다.
- 발급한 토큰 정보를 복사해 요청 시 인증 토큰 정보로 사용합니다.

2) 요청하기 ​

shell
POST https://apis.daglo.ai/nlp/v1/async/minutes

3) 응답받기 ​

shell
GET https://apis.daglo.ai/nlp/v1/async/minutes/{rid}

Success

응답 코드 보기
  • 200
    • requested: 요청이 시작되었습니다.
    • processing: 요약 중입니다.
    • completed: 요약이 완료되었습니다.
    • input_error: 사용자 요청 값에 오류가 있습니다. 확인 후 다시 요청해 주세요.
    • processing_error: 요약 중 오류가 발생하였습니다. 잠시 기다렸다가 다시 요청해 주세요. :::

Error

응답 코드 보기
  • 400 : Bad Request. 요청 형식이 잘못되었습니다.
  • 401 : Unauthorized. 인증 실패.
  • 403 : Forbidden. 접근 금지.
  • 404 : Not Found. 요청한 리소스를 찾을 수 없습니다.
  • 429 : Too Many Requests. 요청 과다.
  • 500 : Internal Server Error. 서버 오류.
  • 503 : Service Unavailable. 서비스 이용 불가.

업데이트 이력

  • 20240902 ver1.0 API 문서가 작성되었습니다.