AI 대화 생성

새 AI 대화 세션을 생성합니다. 호출 계정이 새 대화의 소유자가 됩니다. 본문 매개변수는 받지 않으며, 제목은 사용자가 직접 지정하기 전까지 요청 세션 로캘에 따른 기본값(새 대화 또는 New conversation)이 적용됩니다.

필요 권한

사용자 이상의 계정으로 이용할 수 있습니다.

HTTP 요청

cURL 예시

curl -H "Authorization: Bearer <API_KEY>" \
     -X POST \
     https://HOSTNAME/api/sonar/ai/conversations

요청 매개변수

요청 본문 매개변수가 없습니다.

정상 응답

{
  "guid": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "title": "새 대화"
}

• guid (문자열): 생성된 대화 GUID
• title (문자열): 대화 기본 제목 (요청 세션이 한국어인 경우 새 대화, 그 외에는 New conversation)

오류 응답

권한이 없는 경우

HTTP 상태 코드 500 응답

{
  "error_code": "illegal-state",
  "error_msg": "no-permission"
}