Stop Session

활성 세션을 종료하고 서버 리소스를 해제합니다. 사용자가 대화를 끝내거나 브라우저를 닫을 때 반드시 호출해야 과금이 정확히 집계됩니다. 전체 흐름에서 마지막 단계입니다.

POST/api/v2/sessions/stop

Headers

헤더	값
STUDIO-API-KEY	{userKey}
Content-Type	application/json

Body

파라미터	타입	필수 여부	설명
session_id	string	required	종료할 세션 ID. Start Session 응답의 data.session_id
reason	enum	required	종료 사유. 지원 값은 아래 목록을 참고하세요.

지원되는 reason 값:

UNKNOWN, USER_DISCONNECTED, SERVER_ERROR, IDLE_TIMEOUT, NO_CREDITS, USER_CLOSED, AVATAR_DELETED, MAX_DURATION_REACHED, ZOMBIE_SESSION_REAP, USER_REQUEST_STOP, JOB_COMPLETED, JOB_CANCELLED, JOB_FAILED, BILLING_FAILED, BILLING_CANCELLED, TIMEOUT_INACTIVE, SERVER_SHUTDOWN

예시

cURL

curl https://ai-streamer.deepbrain.io/api/v2/sessions/stop \
-H "Content-Type: application/json" \
-H "STUDIO-API-KEY: ${userKey}" \
-X POST \
-d '{
  "session_id": "${SESSION_ID}",
  "reason": "USER_CLOSED"
}'

Node.js

import axios from "axios";
const userKey = "${userKey}";

axios
  .post(
    "https://ai-streamer.deepbrain.io/api/v2/sessions/stop",
    {
      session_id: "${SESSION_ID}",
      reason: "USER_CLOSED",
    },
    {
      headers: {
        "STUDIO-API-KEY": userKey,
        "Content-Type": "application/json",
      },
    },
  )
  .then((res) => {
    console.log(res.data);
  })
  .catch((error) => {
    console.error(error);
  });

Python

import requests

url = 'https://ai-streamer.deepbrain.io/api/v2/sessions/stop'
user_key = '${userKey}'

headers = {
    'STUDIO-API-KEY': user_key,
    'Content-Type': 'application/json'
}
body = {
    'session_id': '${SESSION_ID}',
    'reason': 'USER_CLOSED'
}

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

성공(code: 1000)

{
  "code": 1000,
  "data": null,
  "message": "Session stopped successfully"
}

Next Step

세션이 성공적으로 종료되면 과금이 정지되고 모든 리소스가 해제됩니다.