Overview
Speech-to-text endpointsAvailable Operations
- createTranscription - Create transcription
- createTranscriptionMultipart - Create transcription
Documentation Index
Fetch the complete documentation index at: /docs/llms.txt
Use this file to discover all available pages before exploring further.
Speech-to-text endpoints
import { OpenRouter } from "@openrouter/sdk";
const openRouter = new OpenRouter({
httpReferer: "<value>",
appTitle: "<value>",
appCategories: "<value>",
apiKey: process.env["OPENROUTER_API_KEY"] ?? "",
});
async function run() {
const result = await openRouter.stt.createTranscription({
sttRequest: {
inputAudio: {
data: "UklGRiQA...",
format: "wav",
},
language: "en",
model: "openai/whisper-large-v3",
},
});
console.log(result);
}
run();
import { OpenRouterCore } from "@openrouter/sdk/core.js";
import { sttCreateTranscription } from "@openrouter/sdk/funcs/sttCreateTranscription.js";
// Use `OpenRouterCore` for best tree-shaking performance.
// You can create one instance of it to use across an application.
const openRouter = new OpenRouterCore({
httpReferer: "<value>",
appTitle: "<value>",
appCategories: "<value>",
apiKey: process.env["OPENROUTER_API_KEY"] ?? "",
});
async function run() {
const res = await sttCreateTranscription(openRouter, {
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();
| Parameter | Type | Required | Description |
|---|---|---|---|
request | operations.CreateAudioTranscriptionsRequest | ✅ | The request object to use for the request. |
options | RequestOptions | ➖ | Used to set various options for making HTTP requests. |
options.fetchOptions | RequestInit | ➖ | 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.retries | RetryConfig | ➖ | Enables retrying HTTP requests under certain failure conditions. |
| Error Type | Status Code | Content Type |
|---|---|---|
| errors.BadRequestResponseError | 400 | application/json |
| errors.UnauthorizedResponseError | 401 | application/json |
| errors.PaymentRequiredResponseError | 402 | application/json |
| errors.ForbiddenResponseError | 403 | application/json |
| errors.NotFoundResponseError | 404 | application/json |
| errors.PayloadTooLargeResponseError | 413 | application/json |
| errors.TooManyRequestsResponseError | 429 | application/json |
| errors.InternalServerResponseError | 500 | application/json |
| errors.BadGatewayResponseError | 502 | application/json |
| errors.ServiceUnavailableResponseError | 503 | application/json |
| errors.GatewayTimeoutResponseError | 504 | application/json |
| errors.EdgeNetworkTimeoutResponseError | 524 | application/json |
| errors.ProviderOverloadedResponseError | 529 | application/json |
| errors.OpenRouterDefaultError | 4XX, 5XX | */* |
import { OpenRouter } from "@openrouter/sdk";
import { openAsBlob } from "node:fs";
const openRouter = new OpenRouter({
httpReferer: "<value>",
appTitle: "<value>",
appCategories: "<value>",
apiKey: process.env["OPENROUTER_API_KEY"] ?? "",
});
async function run() {
const result = await openRouter.stt.createTranscriptionMultipart({
requestBody: {
file: await openAsBlob("example.file"),
language: "en",
model: "openai/whisper-large-v3",
},
});
console.log(result);
}
run();
import { OpenRouterCore } from "@openrouter/sdk/core.js";
import { sttCreateTranscriptionMultipart } from "@openrouter/sdk/funcs/sttCreateTranscriptionMultipart.js";
import { openAsBlob } from "node:fs";
// Use `OpenRouterCore` for best tree-shaking performance.
// You can create one instance of it to use across an application.
const openRouter = new OpenRouterCore({
httpReferer: "<value>",
appTitle: "<value>",
appCategories: "<value>",
apiKey: process.env["OPENROUTER_API_KEY"] ?? "",
});
async function run() {
const res = await sttCreateTranscriptionMultipart(openRouter, {
requestBody: {
file: await openAsBlob("example.file"),
language: "en",
model: "openai/whisper-large-v3",
},
});
if (res.ok) {
const { value: result } = res;
console.log(result);
} else {
console.log("sttCreateTranscriptionMultipart failed:", res.error);
}
}
run();
| Parameter | Type | Required | Description |
|---|---|---|---|
request | operations.CreateAudioTranscriptionsMultipartRequest | ✅ | The request object to use for the request. |
options | RequestOptions | ➖ | Used to set various options for making HTTP requests. |
options.fetchOptions | RequestInit | ➖ | 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.retries | RetryConfig | ➖ | Enables retrying HTTP requests under certain failure conditions. |
| Error Type | Status Code | Content Type |
|---|---|---|
| errors.BadRequestResponseError | 400 | application/json |
| errors.UnauthorizedResponseError | 401 | application/json |
| errors.PaymentRequiredResponseError | 402 | application/json |
| errors.ForbiddenResponseError | 403 | application/json |
| errors.NotFoundResponseError | 404 | application/json |
| errors.PayloadTooLargeResponseError | 413 | application/json |
| errors.TooManyRequestsResponseError | 429 | application/json |
| errors.InternalServerResponseError | 500 | application/json |
| errors.BadGatewayResponseError | 502 | application/json |
| errors.ServiceUnavailableResponseError | 503 | application/json |
| errors.GatewayTimeoutResponseError | 504 | application/json |
| errors.EdgeNetworkTimeoutResponseError | 524 | application/json |
| errors.ProviderOverloadedResponseError | 529 | application/json |
| errors.OpenRouterDefaultError | 4XX, 5XX | */* |