Gladia

Transcribe audio files with Gladia's speech-to-text API.

AI and MLAPI key3 actionsAll integrations

On this page

Connect
Call it from a workflow
Actions (3)
createTranscription
uploadAFile
custom_api_call
Details

Connect

Auth type: API key (secret_text). Paste the API key (or token) from the provider's settings into the connect dialog. It is encrypted at rest and only decrypted on the server when an action runs.

In the editor: Backend panel, Integrations tab, then Connect. This connects it for the project.
For every project in a workspace: Workspace settings, Integrations.
Owners and admins choose which integrations members may connect in the admin panel (Integrations tab), and can attach their own OAuth app there.

Call it from a workflow

Pass the action name and its input. The call resolves with { success, output, error? }; a missing connection resolves with success false and the reason. See ctx.integrations.invoke and ctx.integrations.call.

Native workflow

// .workflow.js (native ctx)
export async function run(ctx) {
  const res = await ctx.integrations.invoke("gladia", "createTranscription", {
    "audio_url": "<audio url>"
  });
  if (!res.success) throw new Error(res.error);
  ctx.log.info("Gladia answered", { output: res.output });
}

defineWorkflow module

// defineWorkflow module (@app/sdk ctx)
import { defineWorkflow } from "@app/sdk";

export default defineWorkflow({
  id: "gladia-createtranscription",
  name: "Gladia: Create Transcription",
  description: "Calls Gladia when a row is created.",
  trigger: { type: "entity_event", entity: "tickets", event: "created" },
  async run(ctx, event) {
    const res = await ctx.integrations.call("gladia", {
      "action": "createTranscription",
      "audio_url": "<audio url>"
    }) as { success: boolean; error?: string };
    if (!res.success) throw new Error(res.error);
  },
});

From an app (connector proxy)

curl -X POST "$APP_ORIGIN/__appbricx/connector-proxy/gladia/createTranscription" \
  -H "Authorization: Bearer $APP_KEY" \
  -H "content-type: application/json" \
  -d '{"props":{"audio_url":"<audio url>"}}'

Actions

createTranscriptionin catalog

Create Transcription. Initiate a pre-recorded transcription job from an audio or video URL

Input	Type	Description
`audio_url`required	long text	URL to a Gladia file or to an external audio or video file
`languages`optional	one of "auto" \| "af" \| "am" \| "ar" \| "as" \| "az" \| "ba" \| "be" \| "bg" \| "bn" \| "bo" \| "br"	Select the language spoken in the audio for better transcription accuracy
`code_switching`optional	boolean	Enable code switching to handle multiple languages in the audio
`subtitles`optional	boolean	Enable subtitles generation for this transcription
`subtitles_format`optional	id (picked from your account)	Select the subtitle format(s) for transcription output
`diarization`optional	boolean	Enable speaker recognition (diarization) for this audio
`translation`optional	boolean	Enable translation for this audio
`summarization`optional	boolean	Enable summarization for this audio
`summarization_type`optional	id (picked from your account)	Choose the type of summarization to apply.
`sentiment_analysis`optional	boolean	Enable sentiment analysis for this audio
`sentences`optional	boolean	Enable sentence detection for this audio
`custom_metadata`optional	object	Add custom metadata to the transcription job

uploadAFilein catalog

Upload Audio File. Upload an audio or video file for use in a pre-recorded transcription job

Input	Type	Description
`audio_file`required	file	The audio or video file to upload

custom_api_call

Custom API Call. Make a custom API call to a specific endpoint

Input	Type	Description
`url`required	object (depends on other props)	url
`method`required	one of "GET" \| "POST" \| "PATCH" \| "PUT" \| "DELETE" \| "HEAD"	Method
`headers`required	object	Authorization headers are injected automatically from your connection.
`queryParams`required	object	Query Parameters
`body_type`optional	one of "none" \| "json" \| "form_data" \| "raw"	Body Type
`body`optional	object (depends on other props)	Body
`response_is_binary`optional	boolean	Enable for files like PDFs, images, etc.
`failsafe`optional	boolean	No Error on Failure
`timeout`optional	number	Timeout (in seconds)
`followRedirects`optional	boolean	Follow redirects

Details

Id: gladia
Category: AI and ML
Tags: speech, transcription, audio, ai
Package: @activepieces/piece-gladia@0.1.4
Tier: Community