For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://modelgates.ai/docs/_mcp/server.

Transcriptions - TypeScript SDK

The TypeScript SDK and docs are currently in beta. Report issues on GitHub.

Overview

Speech-to-text endpoints

Available Operations

createTranscription

Transcribes audio into text. Accepts base64-encoded audio input and returns the transcribed text.

Example Usage

typescript
import { ModelGates } from "@modelgates/sdk"; const modelgates = new ModelGates({  httpReferer: "<value>",  appTitle: "<value>",  appCategories: "<value>",  apiKey: process.env["MODELGATES_API_KEY"] ?? "",}); async function run() {  const result = await modelgates.stt.createTranscription({    sttRequest: {      inputAudio: {        data: "UklGRiQA...",        format: "wav",      },      language: "en",      model: "openai/whisper-large-v3",    },  });   console.log(result);} run();

Standalone function

The standalone function version of this method:

typescript
import { ModelGatesCore } from "@modelgates/sdk/core.js";import { sttCreateTranscription } from "@modelgates/sdk/funcs/sttCreateTranscription.js"; // Use `ModelGatesCore` for best tree-shaking performance.// You can create one instance of it to use across an application.const modelgates = new ModelGatesCore({  httpReferer: "<value>",  appTitle: "<value>",  appCategories: "<value>",  apiKey: process.env["MODELGATES_API_KEY"] ?? "",}); async function run() {  const res = await sttCreateTranscription(modelgates, {    sttRequest: {      inputAudio: {        data: "UklGRiQA...",        format: "wav",      },      language: "en",      model: "openai/whisper-large-v3",    },  });  if (res.ok) {    const { value: result } = res;    console.log(result);  } else {    console.log("sttCreateTranscription failed:", res.error);  }} run();

Parameters

ParameterTypeRequiredDescription
requestoperations.CreateAudioTranscriptionsRequest:heavy_check_mark:The request object to use for the request.
optionsRequestOptions:heavy_minus_sign:Used to set various options for making HTTP requests.
options.fetchOptionsRequestInit:heavy_minus_sign:Options that are passed to the underlying HTTP request. This can be used to inject extra headers for examples. All Request options, except method and body, are allowed.
options.retriesRetryConfig:heavy_minus_sign:Enables retrying HTTP requests under certain failure conditions.

Response

Promise<models.STTResponse>

Errors

Error TypeStatus CodeContent Type
errors.BadRequestResponseError400application/json
errors.UnauthorizedResponseError401application/json
errors.PaymentRequiredResponseError402application/json
errors.NotFoundResponseError404application/json
errors.TooManyRequestsResponseError429application/json
errors.InternalServerResponseError500application/json
errors.BadGatewayResponseError502application/json
errors.ServiceUnavailableResponseError503application/json
errors.EdgeNetworkTimeoutResponseError524application/json
errors.ProviderOverloadedResponseError529application/json
errors.ModelGatesDefaultError4XX, 5XX*/*