ondari / sdk

dev-main 2026-09-13 08:44 UTC

Requires

• php: >=8.1
• ext-curl: *
• ext-json: *

MIT

Published on Packagist.org on 2026-09-13 10:14 UTC

README

The Ondari PHP SDK. Send usage events and read back itemized, explainable costs. Requires PHP 8.1+.

composer require ondari/sdk

Usage

use Ondari\Ondari;

$ondari = new Ondari(apiKey: getenv('ONDARI_KEY'));

$result = $ondari->track([
    'provider' => 'openai',
    'model' => 'gpt-4o',
    'inputTokens' => 1_200_000,
    'outputTokens' => 42_000,
]);

// ['accepted' => true, 'pricingStatus' => 'priced', 'cost' => 3.42,
//  'explanation' => 'OpenAI → gpt-4o → version …: 1.2M input × $2.50 + …']

Batch:

$results = $ondari->trackBatch([
    ['provider' => 'openai', 'model' => 'gpt-4o', 'inputTokens' => 1000, 'outputTokens' => 200],
    ['provider' => 'anthropic', 'model' => 'claude-sonnet-4', 'inputTokens' => 500, 'outputTokens' => 100],
]);

Idempotency

Every event carries an idempotency_key. Omit it and the SDK generates one; pass your own to make retries safe:

use Ondari\Idempotency;

$key = Idempotency::key();
$ondari->track(['provider' => 'openai', 'model' => 'gpt-4o', 'idempotencyKey' => $key]);
// retry the same logical operation safely:
$ondari->track(['provider' => 'openai', 'model' => 'gpt-4o', 'idempotencyKey' => $key]);

Configuration

Argument	Default	Notes
apiKey	—	Required. Project API key from the dashboard.
baseUrl	https://ondari.dev	Point at a self-hosted instance.
retries	3	Retries network errors and 429/5xx with backoff.
http	CurlHttpClient	Inject a transport for testing / custom TLS.

Behavior

• Cost is server-computed — you never send a price.
• Unknown models are accepted (pricingStatus: "unpriced"), never rejected.
• Client errors throw OndariException; rate limits and server errors retry.
• No prompts or completions are ever sent — only metadata and token counts.

See the event spec for the full field reference.