├── .gitignore
├── LICENSE
├── README.md
├── build.gradle
├── gradle
└── wrapper
│ ├── gradle-wrapper.jar
│ └── gradle-wrapper.properties
├── gradlew
├── gradlew.bat
├── settings.gradle
└── src
└── main
├── java
└── elevateAi
│ └── client
│ ├── Client.java
│ └── Main.java
└── resources
└── application.properties
/.gitignore:
--------------------------------------------------------------------------------
1 | README.md
2 | .gradle
3 | build/
4 | !gradle/wrapper/gradle-wrapper.jar
5 | !**/src/main/**/build/
6 | !**/src/test/**/build/
7 |
8 | ### STS ###
9 | .apt_generated
10 | .classpath
11 | .factorypath
12 | .project
13 | .settings
14 | .springBeans
15 | .sts4-cache
16 | bin/
17 | !**/src/main/**/bin/
18 | !**/src/test/**/bin/
19 |
20 | ### IntelliJ IDEA ###
21 | .idea
22 | *.iws
23 | *.iml
24 | *.ipr
25 | out/
26 | !**/src/main/**/out/
27 | !**/src/test/**/out/
28 |
29 | ### NetBeans ###
30 | /nbproject/private/
31 | /nbbuild/
32 | /dist/
33 | /nbdist/
34 | /.nb-gradle/
35 |
36 | ### VS Code ###
37 | .vscode/
38 |
--------------------------------------------------------------------------------
/LICENSE:
--------------------------------------------------------------------------------
1 | MIT License
2 |
3 | Copyright (c) 2023 ElevateAI
4 |
5 | Permission is hereby granted, free of charge, to any person obtaining a copy
6 | of this software and associated documentation files (the "Software"), to deal
7 | in the Software without restriction, including without limitation the rights
8 | to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9 | copies of the Software, and to permit persons to whom the Software is
10 | furnished to do so, subject to the following conditions:
11 |
12 | The above copyright notice and this permission notice shall be included in all
13 | copies or substantial portions of the Software.
14 |
15 | THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16 | IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17 | FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18 | AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19 | LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20 | OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21 | SOFTWARE.
22 |
--------------------------------------------------------------------------------
/README.md:
--------------------------------------------------------------------------------
1 |
2 | 
3 |
4 |
5 |
20 |
21 | # ElevateAI Java SDK
22 |
23 | [ElevateAI](https://www.elevateai.com) provides an API for Speech-to-text (ASR), behavioral analysis and sentiment analysis of voice interactions.
24 |
25 | ### Example
26 | 1. [Signup](https://app.elevateai.com) and retrieve API token from ElevateAI.
27 | 1. Declare an interaction. Provide a URI if you want ElevateAI to download the interaction via a Public URI.
28 | 2. Retrieve Interaction ID from JSON response and store.
29 | 3. Upload a file.
30 | 4. Check status every 30 seconds using Interaction ID until status returns 'processed' or an [error status](https://docs.elevateai.com/tutorials/check-the-processing-status).
31 | 5. Retrieve results - [phrase-by-phrase transcript](https://docs.elevateai.com/tutorials/get-phrase-by-phrase-transcript), [punctuated transcript](https://docs.elevateai.com/tutorials/get-punctuated-transcript), and [AI results](https://docs.elevateai.com/tutorials/get-cx-ai).
32 |
33 |
34 | ```java
35 | import elevateAi.client.Client;
36 |
37 | ... ...
38 | var cli = Client.newInstance(baseUrl, apiToken);
39 |
40 | // Step 2,3
41 | var it = cli.declare("en-us", "default", "highAccuracy", null, null, false);
42 |
43 | // Step 4
44 | var uploadOk = cli.upload(it, "d:/dev/elevateai-cli/sample-media/media.wav");
45 |
46 | // Step 5
47 | while (true){
48 | var s = cli.status(it);
49 | if("processed".equals(s))
50 | break;
51 | Thread.sleep(60000);
52 | }
53 |
54 | var tx = cli.transcripts(it, true);
55 | var ai = cli.aiResults(it);
56 | System.out.println(String.format("Interaction [%s]: \nTranscripts: %s, \nAiResults: %s", it, tx, ai));
57 |
58 | ```
59 |
--------------------------------------------------------------------------------
/build.gradle:
--------------------------------------------------------------------------------
1 | plugins {
2 | id 'java'
3 | id 'org.springframework.boot' version '2.7.7'
4 | id 'io.spring.dependency-management' version '1.1.0'
5 | }
6 |
7 | group = 'elevateAi'
8 | version = '0.0.1-SNAPSHOT'
9 |
10 | repositories {
11 | mavenCentral()
12 | }
13 |
14 | dependencies {
15 | implementation 'com.fasterxml.jackson.core:jackson-databind'
16 | }
--------------------------------------------------------------------------------
/gradle/wrapper/gradle-wrapper.jar:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/NICEElevateAI/ElevateAIJavaSDK/ac892d01d56ca8a8a2003ef92310ecee8ef3779c/gradle/wrapper/gradle-wrapper.jar
--------------------------------------------------------------------------------
/gradle/wrapper/gradle-wrapper.properties:
--------------------------------------------------------------------------------
1 | distributionBase=GRADLE_USER_HOME
2 | distributionPath=wrapper/dists
3 | distributionUrl=https\://services.gradle.org/distributions/gradle-7.6-bin.zip
4 | zipStoreBase=GRADLE_USER_HOME
5 | zipStorePath=wrapper/dists
6 |
--------------------------------------------------------------------------------
/gradlew:
--------------------------------------------------------------------------------
1 | #!/bin/sh
2 |
3 | #
4 | # Copyright © 2015-2021 the original authors.
5 | #
6 | # Licensed under the Apache License, Version 2.0 (the "License");
7 | # you may not use this file except in compliance with the License.
8 | # You may obtain a copy of the License at
9 | #
10 | # https://www.apache.org/licenses/LICENSE-2.0
11 | #
12 | # Unless required by applicable law or agreed to in writing, software
13 | # distributed under the License is distributed on an "AS IS" BASIS,
14 | # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
15 | # See the License for the specific language governing permissions and
16 | # limitations under the License.
17 | #
18 |
19 | ##############################################################################
20 | #
21 | # Gradle start up script for POSIX generated by Gradle.
22 | #
23 | # Important for running:
24 | #
25 | # (1) You need a POSIX-compliant shell to run this script. If your /bin/sh is
26 | # noncompliant, but you have some other compliant shell such as ksh or
27 | # bash, then to run this script, type that shell name before the whole
28 | # command line, like:
29 | #
30 | # ksh Gradle
31 | #
32 | # Busybox and similar reduced shells will NOT work, because this script
33 | # requires all of these POSIX shell features:
34 | # * functions;
35 | # * expansions «$var», «${var}», «${var:-default}», «${var+SET}»,
36 | # «${var#prefix}», «${var%suffix}», and «$( cmd )»;
37 | # * compound commands having a testable exit status, especially «case»;
38 | # * various built-in commands including «command», «set», and «ulimit».
39 | #
40 | # Important for patching:
41 | #
42 | # (2) This script targets any POSIX shell, so it avoids extensions provided
43 | # by Bash, Ksh, etc; in particular arrays are avoided.
44 | #
45 | # The "traditional" practice of packing multiple parameters into a
46 | # space-separated string is a well documented source of bugs and security
47 | # problems, so this is (mostly) avoided, by progressively accumulating
48 | # options in "$@", and eventually passing that to Java.
49 | #
50 | # Where the inherited environment variables (DEFAULT_JVM_OPTS, JAVA_OPTS,
51 | # and GRADLE_OPTS) rely on word-splitting, this is performed explicitly;
52 | # see the in-line comments for details.
53 | #
54 | # There are tweaks for specific operating systems such as AIX, CygWin,
55 | # Darwin, MinGW, and NonStop.
56 | #
57 | # (3) This script is generated from the Groovy template
58 | # https://github.com/gradle/gradle/blob/master/subprojects/plugins/src/main/resources/org/gradle/api/internal/plugins/unixStartScript.txt
59 | # within the Gradle project.
60 | #
61 | # You can find Gradle at https://github.com/gradle/gradle/.
62 | #
63 | ##############################################################################
64 |
65 | # Attempt to set APP_HOME
66 |
67 | # Resolve links: $0 may be a link
68 | app_path=$0
69 |
70 | # Need this for daisy-chained symlinks.
71 | while
72 | APP_HOME=${app_path%"${app_path##*/}"} # leaves a trailing /; empty if no leading path
73 | [ -h "$app_path" ]
74 | do
75 | ls=$( ls -ld "$app_path" )
76 | link=${ls#*' -> '}
77 | case $link in #(
78 | /*) app_path=$link ;; #(
79 | *) app_path=$APP_HOME$link ;;
80 | esac
81 | done
82 |
83 | APP_HOME=$( cd "${APP_HOME:-./}" && pwd -P ) || exit
84 |
85 | APP_NAME="Gradle"
86 | APP_BASE_NAME=${0##*/}
87 |
88 | # Add default JVM options here. You can also use JAVA_OPTS and GRADLE_OPTS to pass JVM options to this script.
89 | DEFAULT_JVM_OPTS='"-Xmx64m" "-Xms64m"'
90 |
91 | # Use the maximum available, or set MAX_FD != -1 to use that value.
92 | MAX_FD=maximum
93 |
94 | warn () {
95 | echo "$*"
96 | } >&2
97 |
98 | die () {
99 | echo
100 | echo "$*"
101 | echo
102 | exit 1
103 | } >&2
104 |
105 | # OS specific support (must be 'true' or 'false').
106 | cygwin=false
107 | msys=false
108 | darwin=false
109 | nonstop=false
110 | case "$( uname )" in #(
111 | CYGWIN* ) cygwin=true ;; #(
112 | Darwin* ) darwin=true ;; #(
113 | MSYS* | MINGW* ) msys=true ;; #(
114 | NONSTOP* ) nonstop=true ;;
115 | esac
116 |
117 | CLASSPATH=$APP_HOME/gradle/wrapper/gradle-wrapper.jar
118 |
119 |
120 | # Determine the Java command to use to start the JVM.
121 | if [ -n "$JAVA_HOME" ] ; then
122 | if [ -x "$JAVA_HOME/jre/sh/java" ] ; then
123 | # IBM's JDK on AIX uses strange locations for the executables
124 | JAVACMD=$JAVA_HOME/jre/sh/java
125 | else
126 | JAVACMD=$JAVA_HOME/bin/java
127 | fi
128 | if [ ! -x "$JAVACMD" ] ; then
129 | die "ERROR: JAVA_HOME is set to an invalid directory: $JAVA_HOME
130 |
131 | Please set the JAVA_HOME variable in your environment to match the
132 | location of your Java installation."
133 | fi
134 | else
135 | JAVACMD=java
136 | which java >/dev/null 2>&1 || die "ERROR: JAVA_HOME is not set and no 'java' command could be found in your PATH.
137 |
138 | Please set the JAVA_HOME variable in your environment to match the
139 | location of your Java installation."
140 | fi
141 |
142 | # Increase the maximum file descriptors if we can.
143 | if ! "$cygwin" && ! "$darwin" && ! "$nonstop" ; then
144 | case $MAX_FD in #(
145 | max*)
146 | MAX_FD=$( ulimit -H -n ) ||
147 | warn "Could not query maximum file descriptor limit"
148 | esac
149 | case $MAX_FD in #(
150 | '' | soft) :;; #(
151 | *)
152 | ulimit -n "$MAX_FD" ||
153 | warn "Could not set maximum file descriptor limit to $MAX_FD"
154 | esac
155 | fi
156 |
157 | # Collect all arguments for the java command, stacking in reverse order:
158 | # * args from the command line
159 | # * the main class name
160 | # * -classpath
161 | # * -D...appname settings
162 | # * --module-path (only if needed)
163 | # * DEFAULT_JVM_OPTS, JAVA_OPTS, and GRADLE_OPTS environment variables.
164 |
165 | # For Cygwin or MSYS, switch paths to Windows format before running java
166 | if "$cygwin" || "$msys" ; then
167 | APP_HOME=$( cygpath --path --mixed "$APP_HOME" )
168 | CLASSPATH=$( cygpath --path --mixed "$CLASSPATH" )
169 |
170 | JAVACMD=$( cygpath --unix "$JAVACMD" )
171 |
172 | # Now convert the arguments - kludge to limit ourselves to /bin/sh
173 | for arg do
174 | if
175 | case $arg in #(
176 | -*) false ;; # don't mess with options #(
177 | /?*) t=${arg#/} t=/${t%%/*} # looks like a POSIX filepath
178 | [ -e "$t" ] ;; #(
179 | *) false ;;
180 | esac
181 | then
182 | arg=$( cygpath --path --ignore --mixed "$arg" )
183 | fi
184 | # Roll the args list around exactly as many times as the number of
185 | # args, so each arg winds up back in the position where it started, but
186 | # possibly modified.
187 | #
188 | # NB: a `for` loop captures its iteration list before it begins, so
189 | # changing the positional parameters here affects neither the number of
190 | # iterations, nor the values presented in `arg`.
191 | shift # remove old arg
192 | set -- "$@" "$arg" # push replacement arg
193 | done
194 | fi
195 |
196 | # Collect all arguments for the java command;
197 | # * $DEFAULT_JVM_OPTS, $JAVA_OPTS, and $GRADLE_OPTS can contain fragments of
198 | # shell script including quotes and variable substitutions, so put them in
199 | # double quotes to make sure that they get re-expanded; and
200 | # * put everything else in single quotes, so that it's not re-expanded.
201 |
202 | set -- \
203 | "-Dorg.gradle.appname=$APP_BASE_NAME" \
204 | -classpath "$CLASSPATH" \
205 | org.gradle.wrapper.GradleWrapperMain \
206 | "$@"
207 |
208 | # Stop when "xargs" is not available.
209 | if ! command -v xargs >/dev/null 2>&1
210 | then
211 | die "xargs is not available"
212 | fi
213 |
214 | # Use "xargs" to parse quoted args.
215 | #
216 | # With -n1 it outputs one arg per line, with the quotes and backslashes removed.
217 | #
218 | # In Bash we could simply go:
219 | #
220 | # readarray ARGS < <( xargs -n1 <<<"$var" ) &&
221 | # set -- "${ARGS[@]}" "$@"
222 | #
223 | # but POSIX shell has neither arrays nor command substitution, so instead we
224 | # post-process each arg (as a line of input to sed) to backslash-escape any
225 | # character that might be a shell metacharacter, then use eval to reverse
226 | # that process (while maintaining the separation between arguments), and wrap
227 | # the whole thing up as a single "set" statement.
228 | #
229 | # This will of course break if any of these variables contains a newline or
230 | # an unmatched quote.
231 | #
232 |
233 | eval "set -- $(
234 | printf '%s\n' "$DEFAULT_JVM_OPTS $JAVA_OPTS $GRADLE_OPTS" |
235 | xargs -n1 |
236 | sed ' s~[^-[:alnum:]+,./:=@_]~\\&~g; ' |
237 | tr '\n' ' '
238 | )" '"$@"'
239 |
240 | exec "$JAVACMD" "$@"
241 |
--------------------------------------------------------------------------------
/gradlew.bat:
--------------------------------------------------------------------------------
1 | @rem
2 | @rem Copyright 2015 the original author or authors.
3 | @rem
4 | @rem Licensed under the Apache License, Version 2.0 (the "License");
5 | @rem you may not use this file except in compliance with the License.
6 | @rem You may obtain a copy of the License at
7 | @rem
8 | @rem https://www.apache.org/licenses/LICENSE-2.0
9 | @rem
10 | @rem Unless required by applicable law or agreed to in writing, software
11 | @rem distributed under the License is distributed on an "AS IS" BASIS,
12 | @rem WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13 | @rem See the License for the specific language governing permissions and
14 | @rem limitations under the License.
15 | @rem
16 |
17 | @if "%DEBUG%"=="" @echo off
18 | @rem ##########################################################################
19 | @rem
20 | @rem Gradle startup script for Windows
21 | @rem
22 | @rem ##########################################################################
23 |
24 | @rem Set local scope for the variables with windows NT shell
25 | if "%OS%"=="Windows_NT" setlocal
26 |
27 | set DIRNAME=%~dp0
28 | if "%DIRNAME%"=="" set DIRNAME=.
29 | set APP_BASE_NAME=%~n0
30 | set APP_HOME=%DIRNAME%
31 |
32 | @rem Resolve any "." and ".." in APP_HOME to make it shorter.
33 | for %%i in ("%APP_HOME%") do set APP_HOME=%%~fi
34 |
35 | @rem Add default JVM options here. You can also use JAVA_OPTS and GRADLE_OPTS to pass JVM options to this script.
36 | set DEFAULT_JVM_OPTS="-Xmx64m" "-Xms64m"
37 |
38 | @rem Find java.exe
39 | if defined JAVA_HOME goto findJavaFromJavaHome
40 |
41 | set JAVA_EXE=java.exe
42 | %JAVA_EXE% -version >NUL 2>&1
43 | if %ERRORLEVEL% equ 0 goto execute
44 |
45 | echo.
46 | echo ERROR: JAVA_HOME is not set and no 'java' command could be found in your PATH.
47 | echo.
48 | echo Please set the JAVA_HOME variable in your environment to match the
49 | echo location of your Java installation.
50 |
51 | goto fail
52 |
53 | :findJavaFromJavaHome
54 | set JAVA_HOME=%JAVA_HOME:"=%
55 | set JAVA_EXE=%JAVA_HOME%/bin/java.exe
56 |
57 | if exist "%JAVA_EXE%" goto execute
58 |
59 | echo.
60 | echo ERROR: JAVA_HOME is set to an invalid directory: %JAVA_HOME%
61 | echo.
62 | echo Please set the JAVA_HOME variable in your environment to match the
63 | echo location of your Java installation.
64 |
65 | goto fail
66 |
67 | :execute
68 | @rem Setup the command line
69 |
70 | set CLASSPATH=%APP_HOME%\gradle\wrapper\gradle-wrapper.jar
71 |
72 |
73 | @rem Execute Gradle
74 | "%JAVA_EXE%" %DEFAULT_JVM_OPTS% %JAVA_OPTS% %GRADLE_OPTS% "-Dorg.gradle.appname=%APP_BASE_NAME%" -classpath "%CLASSPATH%" org.gradle.wrapper.GradleWrapperMain %*
75 |
76 | :end
77 | @rem End local scope for the variables with windows NT shell
78 | if %ERRORLEVEL% equ 0 goto mainEnd
79 |
80 | :fail
81 | rem Set variable GRADLE_EXIT_CONSOLE if you need the _script_ return code instead of
82 | rem the _cmd.exe /c_ return code!
83 | set EXIT_CODE=%ERRORLEVEL%
84 | if %EXIT_CODE% equ 0 set EXIT_CODE=1
85 | if not ""=="%GRADLE_EXIT_CONSOLE%" exit %EXIT_CODE%
86 | exit /b %EXIT_CODE%
87 |
88 | :mainEnd
89 | if "%OS%"=="Windows_NT" endlocal
90 |
91 | :omega
92 |
--------------------------------------------------------------------------------
/settings.gradle:
--------------------------------------------------------------------------------
1 | rootProject.name = 'client'
2 |
--------------------------------------------------------------------------------
/src/main/java/elevateAi/client/Client.java:
--------------------------------------------------------------------------------
1 | package elevateAi.client;
2 |
3 | import java.io.IOException;
4 | import java.math.BigInteger;
5 | import java.net.http.*;
6 | import java.net.URI;
7 | import java.nio.charset.StandardCharsets;
8 | import java.nio.file.Files;
9 | import java.nio.file.Path;
10 | import java.util.ArrayList;
11 | import java.util.List;
12 | import java.util.Map;
13 | import java.util.Random;
14 | import java.util.HashMap;
15 |
16 |
17 | import com.fasterxml.jackson.databind.*;
18 |
19 | public class Client {
20 | public static Client newInstance(String apiBaseUrl, String apiToken) {
21 | return new Client(apiBaseUrl, apiToken);
22 | }
23 |
24 | private String baseUrl;
25 | private String apiToken;
26 | private HttpClient cli;
27 | private ObjectMapper jsonMapper;
28 | private String boundary = new BigInteger(256, new Random()).toString();
29 |
30 | private Client(String baseUrl, String apiToken){
31 | this.baseUrl = baseUrl;
32 | this.apiToken = apiToken;
33 | this.cli = HttpClient.newBuilder().build();
34 |
35 | jsonMapper = new ObjectMapper();
36 | }
37 |
38 | /**
39 | * Declare only
40 | * @param languageTag
41 | * @param vertical
42 | * @param audioTranscriptionMode
43 | * @return
44 | * @throws Exception
45 | */
46 | public Map declare(String languageTag, String vertical, String audioTranscriptionMode) throws Exception {
47 | return declare(languageTag, vertical, audioTranscriptionMode, null, null, false, null, null);
48 | }
49 |
50 | /**
51 | * Declare and upload with default language, vertical, and transcription mode.
52 | * @param mediaUri
53 | * @param mediaFile
54 | * @return
55 | * @throws Exception
56 | */
57 | public Map declare(String mediaUri, String mediaFile ) throws Exception {
58 | return declare("en-us", "default", "highAccuracy", mediaUri, mediaFile, true, null, null);
59 | }
60 |
61 | /**
62 | * Declare and optionally upload/confirm status
63 | * @param languageTag
64 | * @param vertical
65 | * @param audioTranscriptionMode
66 | * @param mediaUri
67 | * @param mediaFile
68 | * @param confirm
69 | * @param originalfilename
70 | * @param externalidentifier
71 | * @return
72 | * @throws Exception
73 | */
74 | public Map declare(String languageTag, String vertical, String audioTranscriptionMode,
75 | String mediaUri, String mediaFile, boolean confirm,
76 | String originalFilename, String externalIdentifier) throws Exception {
77 |
78 | Map pl = new HashMap<>();
79 | pl.put("type", "audio");
80 | pl.put("languageTag", languageTag);
81 | pl.put("vertical", vertical);
82 | pl.put("audioTranscriptionMode", audioTranscriptionMode);
83 | pl.put("includeAiResults", true);
84 |
85 | if(mediaUri!=null)
86 | pl.put("downloadUrl", mediaUri);
87 |
88 | if (originalFilename!=null)
89 | pl.put("originalFilename", originalFilename);
90 |
91 | if (externalIdentifier!=null)
92 | pl.put("externalIdentifier", externalIdentifier);
93 |
94 | var req = HttpRequest.newBuilder()
95 | .uri(new URI(baseUrl+"/interactions"))
96 | .header("X-API-TOKEN", apiToken)
97 | .header("Content-Type", "application/json;charset=UTF-8")
98 | .POST(HttpRequest.BodyPublishers.ofString(jsonMapper.writeValueAsString(pl)))
99 | .build();
100 | HttpResponse rsp = cli.send(req, HttpResponse.BodyHandlers.ofString());
101 | if(rsp.statusCode()!=201)
102 | throw new RuntimeException("Failed to delclare: "+rsp.statusCode());
103 | var it = jsonMapper.readValue(rsp.body(), Map.class);
104 | if(mediaUri==null && mediaFile!=null && upload(it, mediaFile))
105 | it.put("mediaFile", mediaFile);
106 | if(confirm)
107 | it.put("status", status(it));
108 | return it;
109 | }
110 |
111 | /**
112 | * Retrieve interaction status
113 | * @param interaction
114 | * @return
115 | * @throws Exception
116 | */
117 | public String status(Object interaction) throws Exception {
118 | var interactionId = interaction instanceof Map?
119 | ((Map)interaction).get("interactionIdentifier") : interaction;
120 |
121 | HttpRequest req = HttpRequest.newBuilder()
122 | .uri(new URI(String.format(baseUrl+"/interactions/%s/status", interactionId)))
123 | .header("X-API-TOKEN", apiToken)
124 | .GET()
125 | .build();
126 | HttpResponse rsp = cli.send(req, HttpResponse.BodyHandlers.ofString());
127 | if(rsp.statusCode()!=200)
128 | throw new RuntimeException("Failed: "+rsp.statusCode());
129 | var it = jsonMapper.readValue(rsp.body(), Map.class);
130 | return (String)it.get("status");
131 | }
132 |
133 | /**
134 | * Upload media content for declared interaction.
135 | */
136 | public boolean upload(Object interaction, String mediaFile) throws Exception {
137 | var interactionId = interaction instanceof Map?
138 | ((Map)interaction).get("interactionIdentifier") : interaction;
139 | Map pl = Map.of("file", Path.of(mediaFile));
140 |
141 | var req = HttpRequest.newBuilder()
142 | .uri(new URI(String.format(baseUrl+"/interactions/%s/upload", interactionId)))
143 | .header("X-API-TOKEN", apiToken)
144 | .header("Content-Type", "multipart/form-data;boundary=" + boundary)
145 | .POST(ofMimeMultipartData(pl, boundary))
146 | .build();
147 | HttpResponse rsp = cli.send(req, HttpResponse.BodyHandlers.ofString());
148 | return rsp.statusCode()==200;
149 | }
150 |
151 | /**
152 | * Retrieve interaction transcripts
153 | * @param interaction
154 | * @return
155 | * @throws Exception
156 | */
157 | public Object transcripts(Object interaction, boolean punctuated) throws Exception {
158 | var interactionId = interaction instanceof Map?
159 | ((Map)interaction).get("interactionIdentifier") : interaction;
160 | var path = punctuated? "/transcripts/punctuated" : "/transcripts";
161 | var req = HttpRequest.newBuilder()
162 | .uri(new URI(String.format(baseUrl+"/interactions/%s%s", interactionId, path)))
163 | .header("X-API-TOKEN", apiToken)
164 | .header("Content-Type", "application/json;charset=UTF-8")
165 | .GET()
166 | .build();
167 | HttpResponse rsp = cli.send(req, HttpResponse.BodyHandlers.ofString());
168 | if(rsp.statusCode()!=200)
169 | throw new RuntimeException("Failed: "+rsp.statusCode());
170 | var it = jsonMapper.readValue(rsp.body(), Map.class);
171 | return it;
172 | }
173 |
174 | /**
175 | * Retrieve interaction AI results
176 | * @param interaction
177 | * @return
178 | * @throws Exception
179 | */
180 | public Object aiResults(Object interaction) throws Exception {
181 | var interactionId = interaction instanceof Map?
182 | ((Map)interaction).get("interactionIdentifier") : interaction;
183 | var req = HttpRequest.newBuilder()
184 | .uri(new URI(String.format(baseUrl+"/interactions/%s/ai", interactionId)))
185 | .header("X-API-TOKEN", apiToken)
186 | .header("Content-Type", "application/json;charset=UTF-8")
187 | .GET()
188 | .build();
189 | HttpResponse rsp = cli.send(req, HttpResponse.BodyHandlers.ofString());
190 | if(rsp.statusCode()!=200)
191 | throw new RuntimeException("Failed: "+rsp.statusCode());
192 | var it = jsonMapper.readValue(rsp.body(), Map.class);
193 | return it;
194 | }
195 |
196 | private HttpRequest.BodyPublisher ofMimeMultipartData(Map data, String boundary) throws IOException {
197 | List byteArrays = new ArrayList<>();
198 | byte[] separator = ("--" + boundary + "\r\nContent-Disposition: form-data; name=").getBytes(StandardCharsets.UTF_8);
199 |
200 | for (var entry : data.entrySet()) {
201 | byteArrays.add(separator);
202 | if (entry.getValue() instanceof Path) {
203 | var path = (Path) entry.getValue();
204 | String mimeType = Files.probeContentType(path);
205 | byteArrays.add(("\"" + entry.getKey() + "\"; filename=\"" + path.getFileName()
206 | + "\"\r\nContent-Type: " + mimeType + "\r\n\r\n").getBytes(StandardCharsets.UTF_8));
207 | byteArrays.add(Files.readAllBytes(path));
208 | byteArrays.add("\r\n".getBytes(StandardCharsets.UTF_8));
209 | } else {
210 | byteArrays.add(("\"" + entry.getKey() + "\"\r\n\r\n" + entry.getValue() + "\r\n")
211 | .getBytes(StandardCharsets.UTF_8));
212 | }
213 | }
214 | byteArrays.add(("--" + boundary + "--").getBytes(StandardCharsets.UTF_8));
215 | return HttpRequest.BodyPublishers.ofByteArrays(byteArrays);
216 | }
217 | }
218 |
--------------------------------------------------------------------------------
/src/main/java/elevateAi/client/Main.java:
--------------------------------------------------------------------------------
1 | package elevateAi.client;
2 |
3 | public class Main {
4 | public static void main(String argv[]) throws Exception {
5 | if(argv.length<2){
6 | System.out.println("Syntax:");
7 | System.out.println("\njava -jar ");
8 | System.exit(0);
9 | }
10 |
11 | var baseUrl = argv[0];
12 | var apiToken = argv[1];
13 |
14 | var cli = Client.newInstance(baseUrl, apiToken);
15 |
16 | // 1,2. Declare
17 | var it = cli.declare("en-us", "default", "highAccuracy", null, null, false, "sample.wav", "some ext id");
18 |
19 | // 3. Upload media file
20 | var uploadOk = cli.upload(it, "d:/sample.wav");
21 |
22 | // 4. Wait for processing completion
23 | while (true){
24 | var s = cli.status(it);
25 | if("processed".equals(s))
26 | break;
27 | Thread.sleep(60000);
28 | }
29 | var tx = cli.transcripts(it, true);
30 | var ai = cli.aiResults(it);
31 | System.out.println(String.format("Interaction [%s]: \nTranscripts: %s, \nAiResults: %s", it, tx, ai));
32 |
33 | /*
34 | if(argv.length==2){
35 | var rsp = cli.declare(null, "d:/dev/elevateai-cli/sample-media/AOL00001.wav");
36 | System.out.println("Declared:\n" + rsp);
37 | }
38 | else{
39 | var rsp = cli.transcripts(argv[2], true);
40 | System.out.println("Transcripts:\n" + rsp);
41 | }
42 | */
43 | }
44 | }
45 |
--------------------------------------------------------------------------------
/src/main/resources/application.properties:
--------------------------------------------------------------------------------
1 |
2 |
--------------------------------------------------------------------------------