개발자 문서

Application(Client)

• - Application는 자격증명(Client ID, Client Secret)을 Auth Server로 전송하여 Access Token을 요청합니다.

• - 발급 받은 Access Token을 이용하여 Cloud Service를 요청합니다.

Auth Server(Service API)

• - Application이 전달한 자격증명(Client ID, Client Secret)을 확인하여 인가된 사용자의 경우 접근권한이 부여된 Access Token을 발급합니다.

• - Application의 Cloud Service 사용 요청에 대하여 Access Token을 확인하고, 적합한 권한을 갖고 있을 경우 Resource Server로 요청을 전달합니다.

Resource Server(Cloud Service Server)

• - 인가된 사용요청에 대하여 Cloud Service(Selvy TTS)를 수행합니다.

HTTP 요청 URI

POST /oauth/token

요청 Host 구성요소

https://{client_id}:{client_secret}@{domain}/oauth/token?grant_type=client_credentials&scope={service_name}

요청 Parameters

응답 Payloads - application/json

{
	"access_token": string,
	"token_type": string,
	"expires_in": integer,
	"scope": string 
}

HTTP 요청 URI

GET /v2/tts/voices

요청 예시

GET /v2/tts/voices?languageCode=ko-KR HTTP/1.1
Authorization: Bearer ef2acb39-229d-42eb-bb13-1ef7d27f5c0b
Host: cloud.selvy.ai

HTTP Header

요청 Parameters

요청 Payloads

응답 예시

{
	"voices": [{
		"name": "Hyejin",
		"gender": "Female",
		"id": "Hyejin",
		"languageCode": "ko-KR",
		"languageName": "Korean"
	}, {
		"name": "Yujin",
		"gender": "Female",
		"id": "Yujin",
		"languageCode": "ko-KR",
		"languageName": "Korean"
	}, {
		"name": "Aram",
		"gender": "Female",
		"id": "Aram",
		"languageCode": "ko-KR",
		"languageName": "Korean"
	}]
}

응답 Header

응답 Payloads

HTTP 요청 URI

POST /v2/tts/audiomix

요청 예시

POST /v2/tts/audiomix HTTP/1.1
Content-Type: multipart/form-data
Authorization: Bearer ef2acb39-229d-42eb-bb13-1ef7d27f5c0b
Host: cloud.selvy.ai

Body:
file : C:/audio/response.wav
mixingId : m00001

HTTP Header

요청 Parameters

요청 Payloads

응답 예시

{
    "code": "200",
    "message": "Success"
}

응답 Header

응답 Payloads

HTTP 요청 URI

POST /v2/tts/userdic

요청 예시

POST /v2/tts/userdic HTTP/1.1
Content-Type: application/json
Authorization: Bearer ef2acb39-229d-42eb-bb13-1ef7d27f5c0b
Host: cloud.selvy.ai

Body:
{
    "lang": "ko-KR",
    "userDicId": "332321kr",
    "userDicText": "{38선} {삼팔선}\n{63빌딩} {육삼빌딩}\n{^^} {킥킥}"
}

{
    "lang": "zh-CN",
    "userDicId": "332321cn",
    "userDicText": "[W*TEXT] ?池公?\n[W*READ] yan1ji1gong1wen1\n[W*TEXT] NO.1\n[W*READ] di4yi1"
}

{
    "lang": "en-GB",
    "userDicId": "332321gb",
    "userDicText": "[W*TEXT] SELVAS AI\n[W*READ] [\"sElv@s] [\"e\"aI]\n[W*TEXT] TTS\n[W*READ] [t \"i t j e s] "
}

HTTP Header

요청 Parameters

요청 Payloads

응답 예시

{
    "code": "200",
    "message": "Success"
}

응답 Header

응답 Payloads

HTTP 요청 URI

POST /v2/tts/speechsynthesis

요청 예시

POST /v2/tts/speechsynthesis HTTP/1.1
Content-Type: application/json 
Authorization: Bearer ef2acb39-229d-42eb-bb13-1ef7d27f5c0b 
Host: cloud.selvy.ai
{
	"outputFormat": "pcm", 
	"sampleRate": "22050", 
	"text": "안녕하세요", 
	"textType": "text", 
	"voiceId": "Yujin" 
}

HTTP Header

요청 Parameters

요청 Payloads

※ textType의 SSML은 ko-KR, en-US만 지원됩니다.

응답 예시

HTTP/1.1 200
Content-Type: audio/pcm Transfer-Encoding: chunked

<Audio Stream Binary>

응답 Header

응답 Payloads

HTTP 요청 URI

POST /v2/tts/markInfo

요청 예시

POST /v2/tts/markInfo HTTP/1.1
Content-Type: application/json
Authorization: Bearer ef2acb39-229d-42eb-bb13-1ef7d27f5c0b
Host: cloud.selvy.ai

Body:
{
"markInfoKey": "dk12EW4832Rt"
}

HTTP Header

요청 Parameters

요청 Payloads

응답 예시

{
    "highlight": "0\t10\t932\r\n12\t29\t2099\r\n31\t47\t1784",
    "lipsync": "5\t51\t0\t0\t0\t50\t0\r\n3\t21\t42\t0\t50\t147\t21674\r\n1\t3\t26\t47\t197\t130\t6968\r\n4\t21\t0\t0\t327\t87\t9186\r\n2\t10\t22\t0\t415\t160\t6351\r\n
4\t26\t0\t0\t575\t306\t6768\r\n5\t51\t0\t0\t882\t50\t0\r\n5\t51\t0\t0\t932\t550\t0\r\n1\t7\t21\t42\t1482\t195\t15843\r\n2\t3\t21\t0\t1678\t147\t10518",
    "markInfoKey": "dk12EW4832Rt",
    "code": "200",
    "message": "Success"
}

응답 Header

응답 Payloads