---
title: "openvibe-sdk/ai-meter · OpenVibe.Services"
canonical: "https://openvibe.services/docs/sdk/ai-meter"
updated: null
---

# openvibe-sdk/ai-meter · OpenVibe.Services

HTML: [openvibe-sdk/ai-meter · OpenVibe.Services](https://openvibe.services/docs/sdk/ai-meter)

# `openvibe-sdk/ai-meter`

Generated at 2026-11-14 06:36:17 UTC from [`openvibe-contracts v0.419.0`](https://github.com/OpenVibers/OpenVibe.Contracts/tree/v0.419.0) and [`openvibe-sdk v0.168.0`](https://github.com/OpenVibers/OpenVibe.SDK/tree/v0.168.0).

From `types/ai-meter.d.ts` (both). Declarations are shown verbatim.

## type Operation

~~~~
export type Operation = 'chat' | 'completion' | 'embedding' | 'image' | 'image_edit' | 'speech' | 'transcription' | 'translation' | 'rerank' | 'moderation' | 'decision' | 'realtime' | 'batch' | 'tool' | 'other';
~~~~

## type Place

~~~~
export type Place = 'provider' | 'machine' | 'community' | 'plan' | 'host';
~~~~

## interface Tokens

~~~~
export interface Tokens { input: number; output: number; reasoning: number; cache_read: number; cache_write: number; ollama?: { eval_ms: number | null } }
~~~~

## interface CallRecord

~~~~
export interface CallRecord { system: string; provider: string; model: string; run_id?: string; turn_id?: string; surface: string; outcome: 'succeeded' | 'failed' | 'cancelled' | 'cached'; at: string; input: number; output: number; reasoning: number; cache_read: number; cache_write: number; latency_ms: number; ttft_ms: number | null; attempts: number; streamed: boolean; tps: number | null; [k: string]: unknown }
~~~~

## interface Call

~~~~
export interface Call { queued(ms: number): Call; firstToken(): Call; tool(count?: number): Call; end(e?: { usage?: unknown; outcome?: string; fallbacks?: number; cache_hit?: boolean; error_class?: string; task_ms?: number; charged_usd?: number; images?: number; audio_seconds?: number }): CallRecord; }
~~~~

## export export function startCall(o: { system: string; provider: str

~~~~
export function startCall(o: { system: string; provider: string; model: string; run_id?: string; turn_id?: string; operation?: Operation; task?: string; task_id?: string; harness?: string; place?: Place; surface?: string; streamed?: boolean; region?: string; subject?: unknown; attribution?: string; paid_by?: string; effort?: string; now?: () => number }): Call;
~~~~

## export export function normalize(usage: unknown): Tokens;

~~~~
export function normalize(usage: unknown): Tokens;
~~~~

## export export function tokensPerSecond(output: number, ms: number):

~~~~
export function tokensPerSecond(output: number, ms: number): number | null;
~~~~

## export export function createMeterClient(o: { aiUrl: string; tokenC

~~~~
export function createMeterClient(o: { aiUrl: string; tokenClient?: { getToken(ctx?: { audience?: string }): Promise<string>; invalidate?(): void } | null; fetch?: typeof fetch; batch?: number; flushMs?: number; maxQueue?: number; log?: { warn?(m: string): void }; audience?: string }): { record(rec: CallRecord): boolean; flush(): Promise<void>; close(): Promise<void>; stats(): { sent: number; dropped: number; rejected: number; retried: number; queued: number } };
~~~~

## export export const OPERATIONS: Operation\[\];

~~~~
export const OPERATIONS: Operation[];
~~~~

## export export const PLACES: Place\[\];

~~~~
export const PLACES: Place[];
~~~~

## export export const OUTCOMES: string\[\];

~~~~
export const OUTCOMES: string[];
~~~~