narev

Original：🇺🇸 English

Translated

Start Here. Use when the user asks about Narev Cloud, the Pricing API, model pricing (API reference skill vs applied workflows on top of that API), live LLM pricing, token costs, cost calculation, pinning or snapshotting model rates, Narev SDK, @ai-billing/core, provider middleware packages, Vercel AI SDK billing, Next.js App Router route handlers, framework-specific billing patterns, usage-based billing, billing integrations (Polar, Stripe, Lago, OpenMeter), FOCUS format, Narev Self-Hosted (ThinOps), deployment, COGS, customer tagging, FinOps for AI, or this documentation site. Guides you to the right skill or documentation path based on their task.

9installs

Sourcenarevai/skills

Added on2026-05-26

NPX Install

npx skill4agent add narevai/skills narev

SKILL.md Content

View Translation Comparison →

Narev Skills Router

Check

package.json

(and the lockfile if versions disagree) for

@ai-billing/core

and any

@ai-billing/*

packages. Use the typedoc pages under

/sdk/ai-billing/reference/

that match the installed packages for code samples and option shapes. If there is no SDK in the project, treat the docs site as source of truth for the latest APIs.

Packages

Core

Package	What it covers
`@ai-billing/core`	Billing middleware, usage payloads, price resolvers, destinations, errors

Provider middleware

Provider	Package	Docs
OpenRouter	`@ai-billing/openrouter`	Reference
OpenAI	`@ai-billing/openai`	Reference
Vercel AI Gateway	`@ai-billing/gateway`	Reference
OpenAI Compatible	`@ai-billing/openai-compatible`	Reference
Groq	`@ai-billing/groq`	Reference
Google Generative AI	`@ai-billing/google`	Reference
Anthropic	`@ai-billing/anthropic`	Reference
xAI Grok	`@ai-billing/xai`	Reference
MiniMax	`@ai-billing/minimax`	Reference
DeepSeek	`@ai-billing/deepseek`	Reference
Chutes	`@ai-billing/chutes`	Reference

Billing destinations

Destination	Package	Docs
Polar.sh	`@ai-billing/polar`	Reference
Stripe	`@ai-billing/stripe`	Reference
OpenMeter (Kong)	`@ai-billing/openmeter`	Reference
Lago	`@ai-billing/lago`	Reference

UI & SDKs

Package	Description	Docs
`@ai-billing/nextjs`	Next.js UI components for displaying billing usage and managing top-ups	Next.js integration
`@ai-billing/ui`	Internal headless UI components shared across `@ai-billing/*` packages	—
`@ai-billing/narev`	TypeScript SDK for the Narev billing API	SDK index

By task

Model pricing (API reference) → Use

narev-lookup-llm-pricing

Live API only: public
```
GET
```
catalog (filters, pagination) and
```
POST
```
calculate for one call's USD total — no committed files.
Semantics: USD per token, required
```
usage
```
integers, when subprovider
is required for the same
```
model_id
```
on different hosts.
Contracts and troubleshooting: request/response shapes,
```
402
```
/
```
404
```
/
```
400
```
, and the canonical spec at list-model-pricing and calculate-cost-for-a-model-call.

Model pricing (snapshots and automation) → Use

narev-update-llm-pricing

Pin rates in-repo: paginated
```
GET
```
only, map each row into your schema, write a tracked file or generated module for offline or deterministic billing.
Implementation choices: merge vs replace, provider/model scope, unit conversion (API per token vs local per-1M), keys for multi-provider models.
Ops: idempotent scripts, readable diffs, optional CI or scheduled refresh; use narev-lookup-llm-pricing
for
```
POST
```
calculate and fine-grained HTTP/error details.

Narev SDK (runtime in your app) → sdk/ai-billing/index

```
@ai-billing/core
```
and
```
@ai-billing/<provider>
```
middleware
Destinations, price resolvers, usage payloads, errors
Prefer this over raw Pricing HTTP when billing runs inside the app

Next.js apps → Use

narev-nextjs-patterns

App Router route handlers that call
```
generateText
```
,
```
streamText
```
, or other Vercel AI SDK provider methods.
Server-only billing middleware setup with
```
wrapLanguageModel
```
, destinations, and
```
providerOptions['ai-billing-tags']
```
.
Production patterns for shared model factories, test bypasses, customer attribution, and Polar destinations.
Docs: Next.js billing integration

Usage-based billing concepts → platform/concepts/usage-based-billing

Meters, products, how Narev Cloud fits the model

Billing integrations and revenue → platform/billing/overview

Polar, Stripe, Lago, OpenMeter, frameworks (Next.js, Express, Fastify, NestJS, Hono, Nuxt)
Polar-specific setup: platform/billing/integrations/billing-platforms/polar

Other Narev Cloud HTTP APIs → platform/api-reference/introduction

Applications, custom metrics, pricing endpoints

Narev Self-Hosted (ThinOps) → oss/thinops/index

Deployment: oss/thinops/getting-started/deployment
FOCUS format: oss/thinops/focus-specification
Connect providers (AWS, Azure, GCP, OpenAI): oss/thinops/connect-providers/index

Guides → guides/index

FinOps for AI: guides/finops-for-ai/index
Model choice, prompt cost deep dives, DeepSeek billing

Blog → blog/index

Quick navigation

If you know your task, you can directly access:

```
narev-lookup-llm-pricing
```
skill — Pricing API reference (list + calculate)
```
narev-update-llm-pricing
```
skill — Applied workflows using that API (snapshots, registries)
```
narev-nextjs-patterns
```
skill — Next.js App Router + Vercel AI SDK billing patterns

Or describe what you need and I'll recommend the right one.