Class default

Index

Constructors

Methods

isValidModel availableModels checkSubscriptionAccess message messageWithTools calculatePrice calculatePriceDetailed clearCache transcribe

Constructors

constructor

new default(apiKey?: string): default
Creates a new AIManager instance configured for OpenRouter
Parameters
- OptionalapiKey: string
  OpenRouter API key (defaults to OPENROUTER_API_KEY env var)
Returns default
- Defined in apps/api/src/libs/ai-manager.ts:75

Methods

isValidModel

isValidModel(modelId: string): Promise<boolean>
Checks if a model ID is valid and available
Parameters
- modelId: string
  The model ID to validate
Returns Promise<boolean>
True if the model is valid, false otherwise
- Defined in apps/api/src/libs/ai-manager.ts:135

availableModels

availableModels(): Promise<AIModel[]>
Fetches all available models from OpenRouter with their pricing information Results are cached in Redis for 3 hours to avoid excessive API calls

Returns Promise<AIModel[]>
Array of available models with pricing details
- Defined in apps/api/src/libs/ai-manager.ts:146

checkSubscriptionAccess

checkSubscriptionAccess(userId: string): Promise<void>
Checks if a user has an active subscription and is within their spending limits
Parameters
- userId: string
  The user ID to check
Returns Promise<void>
Throws
SubscriptionError if user doesn't have access
- Defined in apps/api/src/libs/ai-manager.ts:188

message

message(
    model: string,
    messages: AIMessage[],
    userId: string,
): Promise<AIMessageResponse>
Sends a chat completion request to OpenRouter and returns the response with usage data and cost Automatically fetches pricing data if not already cached Records usage to the database within a MongoDB transaction Checks subscription status and reports metered overage to Stripe
Parameters
- model: string
  The model ID to use (e.g., "anthropic/claude-3.5-sonnet")
- messages: AIMessage[]
  Array of chat messages
- userId: string
  The user ID to associate with this usage record (required)
Returns Promise<AIMessageResponse>
Object containing the AI's response text, token usage, cost, and detailed cost breakdown

Throws
Error if userId is not provided or if any part of the operation fails

Throws
SubscriptionError if user doesn't have an active subscription or has exceeded limits
- Defined in apps/api/src/libs/ai-manager.ts:245

messageWithTools

messageWithTools(
    model: string,
    messages: AIMessageWithTools[],
    tools: AIToolDefinition[],
    userId: string,
): Promise<AIMessageWithToolsResponse>
Sends a chat completion request with tool definitions to OpenRouter Used by the agent loop for LLM-driven tool orchestration
Parameters
- model: string
  The model ID to use (e.g., "anthropic/claude-sonnet-4.5")
- messages: AIMessageWithTools[]
  Array of chat messages (including tool results)
- tools: AIToolDefinition[]
  Array of tool definitions
- userId: string
  The user ID to associate with this usage record
Returns Promise<AIMessageWithToolsResponse>
Object containing the AI's response, tool calls, usage, and cost
- Defined in apps/api/src/libs/ai-manager.ts:343

calculatePrice

calculatePrice(model: string, usage: AITokenUsage): Promise<number>
Calculates the cost of a completed API request based on token usage and model pricing Uses Decimal.js for precise financial calculations without floating-point errors Automatically fetches pricing data if not already cached
Parameters
- model: string
  The model ID that was used
- usage: AITokenUsage
  Token usage information from the API response
Returns Promise<number>
Cost in USD as a number
- Defined in apps/api/src/libs/ai-manager.ts:479

calculatePriceDetailed

calculatePriceDetailed(
model: string,
usage: AITokenUsage,
): Promise<AICostBreakdown>
Calculates detailed cost breakdown for a completed API request Uses Decimal.js for precise financial calculations without floating-point errors Automatically fetches pricing data if not already cached
Parameters
- model: string
  The model ID that was used
- usage: AITokenUsage
  Token usage information from the API response
Returns Promise<AICostBreakdown>
Detailed cost breakdown with prompt, completion, and total costs
- Defined in apps/api/src/libs/ai-manager.ts:507

clearCache

clearCache(): Promise<void>
Clears the pricing and models cache from Redis, forcing fresh data on next request

Returns Promise<void>
- Defined in apps/api/src/libs/ai-manager.ts:536

transcribe

transcribe(
    audioInput: string,
    userId: string,
    language?: string,
): Promise<TranscribeAudioResponse>
Transcribes audio to text using Replicate's Whisper model Records usage to the database and calculates cost based on predict_time
Parameters
- audioInput: string
  Either a data URI (data:audio/...) or a URL to the audio file
- userId: string
  The user ID to associate with this usage record (required)
- Optionallanguage: string
  Optional language hint (e.g., "en", "es")
Returns Promise<TranscribeAudioResponse>
Object containing transcribed text, duration, and cost

Throws
SubscriptionError if user doesn't have an active subscription or has exceeded limits
- Defined in apps/api/src/libs/ai-manager.ts:549

Class default

Index

Constructors

Methods

Constructors

constructor

Parameters

Returns default

Methods

isValidModel

Parameters

Returns Promise<boolean>

availableModels

Returns Promise<AIModel[]>

checkSubscriptionAccess

Parameters

Returns Promise<void>

Throws

message

Parameters

Returns Promise<AIMessageResponse>

Throws

Throws

messageWithTools

Parameters

Returns Promise<AIMessageWithToolsResponse>

calculatePrice

Parameters

Returns Promise<number>

calculatePriceDetailed

Parameters

Returns Promise<AICostBreakdown>

clearCache

Returns Promise<void>

transcribe

Parameters

Returns Promise<TranscribeAudioResponse>

Throws

Settings

On This Page