Create Session Token

스트리밍 세션을 시작하기 위한 인증 토큰을 발급합니다. 발급된 session_token은 이후 Start Session, Talk 등 모든 세션 API의 Authorization: Bearer 헤더에 사용됩니다.

POST/api/v2/sessions/token

Body

파라미터	타입	필수 여부	설명
appId	string	required	AI Studios 계정과 연동된 앱 식별자
userKey	string	required	API 인증 키. userKey는 계정 단위 API 키로, 외부에 노출되지 않도록 주의필요 (서버에서만 사용 권장)

Response

필드	타입	설명	필수
code	integer	API 응답 코드. 1000은 성공을 의미합니다	required
data	object	응답 데이터 객체	required
data.session_token	string	세션 인증 토큰 (JWT). Start / Talk API에서 Authorization 헤더로 사용	required
message	string	응답 메시지	required

예시

cURL

curl https://ai-streamer.deepbrain.io/api/odin/v3/avatars/customavatar\
-H "Content-Type: application/json"\
-X POST\
-d '{   
  "appId": "studiov3.user@example.com",    
  "userKey": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
}'

Node.js

import axios from 'axios'

axios.post(
  'https://ai-streamer.deepbrain.io/api/odin/v3/avatars/customavatar',
  {
    appId: 'studiov3.user@example.com',
    userKey: 'xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx'
  },
  {
    headers: {
      '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/odin/v3/avatars/customavatar'
headers = {
    'Content-Type': 'application/json'
}
body = {
    'appId': 'studiov3.user@example.com',
    'userKey': 'xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx'
}

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

성공 (code: 1000)

{
  "code": 1000,
  "data": {
    "session_token": "${SESSION_TOKEN}"
  },
  "message": "세션 토큰이 생성되었습니다"
}

Next Step

발급받은 session_token으로 Start Session API를 호출합니다.