Test

<back to all web services

SpeechToText

AI

Convert speech to text

import java.math.*;
import java.util.*;
import java.io.InputStream;
import net.servicestack.client.*;
import com.google.gson.annotations.*;
import com.google.gson.reflect.*;

public class dtos
{

    /**
    * Convert speech to text
    */
    @Api(Description="Convert speech to text")
    public static class SpeechToText implements IGeneration
    {
        /**
        * The audio stream containing the speech to be transcribed
        */
        @ApiMember(Description="The audio stream containing the speech to be transcribed")
        @Required()
        public String audio = null;

        /**
        * Optional client-provided identifier for the request
        */
        @ApiMember(Description="Optional client-provided identifier for the request")
        public String refId = null;

        /**
        * Tag to identify the request
        */
        @ApiMember(Description="Tag to identify the request")
        public String tag = null;
        
        public String getAudio() { return audio; }
        public SpeechToText setAudio(String value) { this.audio = value; return this; }
        public String getRefId() { return refId; }
        public SpeechToText setRefId(String value) { this.refId = value; return this; }
        public String getTag() { return tag; }
        public SpeechToText setTag(String value) { this.tag = value; return this; }
    }

    /**
    * Response object for text generation requests
    */
    @Api(Description="Response object for text generation requests")
    public static class TextGenerationResponse
    {
        /**
        * List of generated text outputs
        */
        @ApiMember(Description="List of generated text outputs")
        public ArrayList<TextOutput> results = null;

        /**
        * Detailed response status information
        */
        @ApiMember(Description="Detailed response status information")
        public ResponseStatus responseStatus = null;
        
        public ArrayList<TextOutput> getResults() { return results; }
        public TextGenerationResponse setResults(ArrayList<TextOutput> value) { this.results = value; return this; }
        public ResponseStatus getResponseStatus() { return responseStatus; }
        public TextGenerationResponse setResponseStatus(ResponseStatus value) { this.responseStatus = value; return this; }
    }

    /**
    * Output object for generated text
    */
    public static class TextOutput
    {
        /**
        * The generated text
        */
        @ApiMember(Description="The generated text")
        public String text = null;
        
        public String getText() { return text; }
        public TextOutput setText(String value) { this.text = value; return this; }
    }

}

Java SpeechToText DTOs

To override the Content-type in your clients, use the HTTP Accept Header, append the .jsv suffix or ?format=jsv

HTTP + JSV

The following are sample HTTP requests and responses. The placeholders shown need to be replaced with actual values.

POST /jsv/reply/SpeechToText HTTP/1.1 
Host: test.servicestack.net 
Accept: text/jsv
Content-Type: text/jsv
Content-Length: length

{
	audio: String,
	refId: String,
	tag: String
}
HTTP/1.1 200 OK
Content-Type: text/jsv
Content-Length: length

{
	results: 
	[
		{
			text: String
		}
	],
	responseStatus: 
	{
		errorCode: String,
		message: String,
		stackTrace: String,
		errors: 
		[
			{
				errorCode: String,
				fieldName: String,
				message: String,
				meta: 
				{
					String: String
				}
			}
		],
		meta: 
		{
			String: String
		}
	}
}