VendoVendo Docs
Integrations

AssemblyAI

Speech-to-text transcription. Vendo holds the upstream credential and bills per hour of audio.

Drop-in AssemblyAI Universal-3 transcription. Point the official SDK at Vendo's proxy and Vendo authenticates the call, forwards to AssemblyAI, and bills per audio-hour transcribed. Polling the transcript endpoint is dedup'd so you're only charged once per completed transcript regardless of how many times the client polls.

Auth modes

ProfileDefaultHow it works
vendo_managed_pool (Vendo-managed pool)YesVendo holds the upstream credential and bills per call against the tenant's Vendo balance. No tenant signup with the provider required.

Environment variables

These are the env vars Vendo injects into your deployment at boot when this integration is bound. Source values are resolved by resolveConnectionEnvVars in packages/integrations/lib/ from the connection record (credential, metadata) and deployment context (proxy URL, Vendo-issued API key).

VariableProfilesSourceSecret
ASSEMBLYAI_API_KEYallVendo-issued API key (vendo_sk_*)Yes
ASSEMBLYAI_BASE_URLallVendo proxy base URL (https://<slug>-proxy.vendo.run/v1)No

Reading the credential at runtime

Vendo writes ASSEMBLYAI_API_KEY (and any companion vars above) into your deployment's environment at boot — the official AssemblyAI SDK auto-discovers it, so most code just instantiates the client with no extra wiring. vendo.token(slug) is the resolution-chain-aware alternative that reads the same value in Vendo mode and falls back to whatever you set in OSS mode; use whichever fits your style. See Two modes for the full resolution chain.

Proxy endpoint

Calls to AssemblyAI are brokered through Vendo's proxy at:

https://assemblyai-proxy.vendo.run

Point the official AssemblyAI SDK at this base URL; Vendo authenticates, meters per call, and forwards upstream. Your code never sees the upstream credential.

Quickstart

import vendo

# Async speech-to-text through Vendo. Same AssemblyAI API, billed per hour of audio against your Vendo balance.
token = vendo.token("assemblyai")

# Use `token` wherever you would have used the provider's API key —
# pass it to the official SDK or set it as the env var the SDK reads.
print(token)
import { Vendo } from "@vendodev/sdk";

const vendo = new Vendo();
// Async speech-to-text through Vendo. Same AssemblyAI API, billed per hour of audio against your Vendo balance.
const assemblyaiToken = await vendo.token("assemblyai");

// Use `assemblyaiToken` wherever you would have used the provider's API
// key — pass it to the official SDK or read it as the env var the SDK expects.
console.log(assemblyaiToken);
import VendoSDK

let vendo = Vendo()
// Async speech-to-text through Vendo. Same AssemblyAI API, billed per hour of audio against your Vendo balance.
let token = try await vendo.token("assemblyai")

// Use `token` wherever you would have used the provider's API key.
print(token)

Learn more

On this page