prerecorded

Documentation

Overview

This package provides the prerecorded client implementation for the Deepgram API

Index

• Constants
• Variables
• func Init(init InitLib)
• func InitWithDefault()
• func IsURL(str string) bool
• type Client
  • func New(apiKey string, options *interfaces.ClientOptions) *Client
  • func NewWithDefaults() *Client
  • func (c *Client) DoFile(ctx context.Context, filePath string, ...) error
  • func (c *Client) DoStream(ctx context.Context, src io.Reader, ...) error
  • func (c *Client) DoURL(ctx context.Context, audioURL string, ...) error
• type InitLib

Constants

const (
	LogLevelDefault   = common.LogLevelDefault
	LogLevelErrorOnly = common.LogLevelErrorOnly
	LogLevelStandard  = common.LogLevelStandard
	LogLevelElevated  = common.LogLevelElevated
	LogLevelFull      = common.LogLevelFull
	LogLevelDebug     = common.LogLevelDebug
	LogLevelTrace     = common.LogLevelTrace
	LogLevelVerbose   = common.LogLevelVerbose
)

please see pkg/common/init.go for more information

Variables

var (
	// ErrInvalidInput required input was not found
	ErrInvalidInput = errors.New("required input was not found")
)

errors

Functions

func Init

func Init(init InitLib)

The SDK Init function for this library. Allows you to set the logging level and use of a log file. Default is output to the stdout.

func InitWithDefault

func InitWithDefault()

InitWithDefault is the SDK Init function for this library using default values.

func IsURL

func IsURL(str string) bool

IsURL returns true if a string is of a URL format

Types

type Client

type Client struct {
	*common.Client
}

Client implements helper functionality for Prerecorded API

func New

func New(apiKey string, options *interfaces.ClientOptions) *Client

New creates a new prerecorded client with the specified options

Input parameters: - ctx: context.Context object - apiKey: string containing the Deepgram API key - options: ClientOptions which allows overriding things like hostname, version of the API, etc.

func NewWithDefaults

func NewWithDefaults() *Client

NewWithDefaults creates a new prerecorded client with all default options

Notes:

• The Deepgram API KEY is read from the environment variable DEEPGRAM_API_KEY

func (*Client) DoFile

func (c *Client) DoFile(ctx context.Context, filePath string, req *interfaces.PreRecordedTranscriptionOptions, resBody interface{}) error

DoFile posts a file capturing a conversation to a given REST endpoint

Input parameters: - filePath: string containing the path to the file to be posted - req: PreRecordedTranscriptionOptions which allows overriding things like language, etc.

Output parameters: - resBody: interface{} which will be populated with the response from the server

func (*Client) DoStream

func (c *Client) DoStream(ctx context.Context, src io.Reader, options *interfaces.PreRecordedTranscriptionOptions, resBody interface{}) error

DoStream posts a stream capturing a conversation to a given REST endpoint

Input parameters: - src: io.Reader containing the stream to be posted - req: PreRecordedTranscriptionOptions which allows overriding things like language, etc.

Output parameters: - resBody: interface{} which will be populated with the response from the server

DoStream initiates a streaming API request.

func (*Client) DoURL

func (c *Client) DoURL(ctx context.Context, audioURL string, options *interfaces.PreRecordedTranscriptionOptions, resBody interface{}) error

DoURL posts a URL capturing a conversation to a given REST endpoint

Input parameters: - url: string containing the URL to be posted - req: PreRecordedTranscriptionOptions which allows overriding things like language, etc.

Output parameters: - resBody: interface{} which will be populated with the response from the server

type InitLib

type InitLib struct {
	LogLevel      common.LogLevel
	DebugFilePath string
}

Initialization options for this SDK.