목적

이 API는 사용자 메시지를 전달하고, AI의 응답을 스트림 방식으로 제공합니다.

URL

<aside> 💡

https://api.sidetalk.ai/v1/chat/completions

</aside>

HTTP 메서드

POST

헤더

헤더 값 설명
Content-Type application/json 요청 본문이 JSON 형식임을 나타냅니다.
Authorization Bearer <api_key> Sidetalk 대시보드에서 설치하기 메뉴에 제공된 API 키를 사용하세요.

본문

파라미터 타입 필수 설명
message String 예 사용자 메시지입니다.
stream Boolean 아니요 응답을 스트림으로 받을지 여부를 지정합니다. true 또는 false. 지정하지 않으면 기본값 false가 사용됩니다.

요청 예시

curl -X POST <https://api.sidetalk.ai/v1/chat/completions> \\
  -H "Content-Type: application/json" \\
  -H "Authorization: Bearer ${API_KEY}" \\
  -d '{
      "message": "안녕하세요, 도움이 필요해요.",
      "stream": true
  }'

응답 형식

응답은 stream 파라미터의 값에 따라 두 가지 방식으로 제공됩니다.