App Execute API
App Execute API를 이용하여 CLOVA Studio에서 만들어둔 프롬프트에 이어서 텍스트를 입력하고 결과값을 받을 수 있는 앱을 생성할 수 있습니다. Completion API를 통한 텍스트 처리를 앱이 대신하게 되며, 대화가 생성되었을 때 함께 생성된 Session ID를 요청에 지정하여 대화를 이어나갈 수 있습니다.
요청
POST: /v1/apps/execute
요청 헤더
| Name |
Required |
Description |
| Authorization |
필수 |
토큰 발급 API를 통해 발급 받은 토큰. |
| X-Session-Id |
선택 |
기존 Session ID. Session ID를 지정하여 이전 결과를 활용한 응답을 받을 수 있음 |
요청 바디
| Name |
Type |
Required |
Description |
| sendMessage |
string |
필수 |
입력값으로 사용할 텍스트. |
{
"sendMessage": "안녕~ 만나서 반가워~"
}
응답
| Key |
Type |
Required |
Description |
| receiveMessage |
string |
O |
결과값으로 출력된 텍스트 |
| sessionId |
string |
O |
생성된 결과값이 포함된 프롬프트의 Session ID. 다른 요청의 헤더에 해당 값을 입력하여 대화를 계속 이어나갈 수 있음 |
{
"status": {
"code": "20000",
"message": "OK"
},
"result": {
"receiveMessage": "안녕",
"sessionId": "516610fb-7e3b-4056-b7c0-950fb8cc99fa"
}
}