Talk

활성 세션에 사용자 텍스트 메시지를 전달하여 아바타가 응답을 생성하고 발화하도록 요청합니다.

POST/api/v2/sessions/{sessionId}/talk

Headers

헤더	값
Authorization	Bearer {session_token}
Content-Type	application/json

Body

파라미터	타입	필수 여부	설명
message	string	required	사용자 텍스트 (server-side max length 적용)
type	string	optional	향후 확장용 (기본값 사용, 별도 설정 불필요)

참고 - 세션은 생성된 appId에 종속됩니다. - 다른 appId로 생성된 sessionId에는 접근할 수 없습니다.

팁: [FIRST_MESSAGE] 뒤에 붙은 텍스트는 그대로 아바타가 발화하므로, 아바타가 말해야 할 최종 발화문이 이미 준비되어 있을 때, 해당 응답을 직접 주입하는 용도로도 활용할 수 있습니다.

예시

cURL

curl https://ai-streamer.deepbrain.io/api/v2/sessions/${SESSION_ID}/talk \
-H "Content-Type: application/json" \
-H "Authorization: Bearer ${SESSION_TOKEN}" \
-X POST \
-d '{
  "message": "Hello."
}'

Node.js

import axios from "axios";
const sessionId = "${SESSION_ID}";
const sessionToken = "${SESSION_TOKEN}";

axios
  .post(
    `https://ai-streamer.deepbrain.io/api/v2/sessions/${sessionId}/talk`,
    {
      message: "Hello.",
    },
    {
      headers: {
        Authorization: `Bearer ${sessionToken}`,
        "Content-Type": "application/json",
      },
    },
  )
  .then((res) => {
    console.log(res.data);
  })
  .catch((error) => {
    console.error(error);
  });

Python

import requests

session_id = '${SESSION_ID}'
session_token = '${SESSION_TOKEN}'
url = f'https://ai-streamer.deepbrain.io/api/v2/sessions/{session_id}/talk'

headers = {
    'Authorization': f'Bearer {session_token}',
    'Content-Type': 'application/json'
}
body = {
    'message': 'Hello.'
}

response = requests.post(url, headers=headers, json=body)
print(response.json())

성공 (code: 1000)

{
  "code": 1000,
  "data": null,
  "message": "Message sent successfully"
}

Next Step

사용자와의 대화를 계속하려면 이 API를 반복 호출합니다. 필요시 List Sessions나 Get Session Detail로 세션을 관리하고, 대화를 끝내려면 Stop Session을 호출하세요.