@apivexa/ai

Provider-neutral AI abstraction for ApiVexa — swap models without changing your code.

Part of ApiVexa — AI-powered API User Guide Generator.

Install

npm install @apivexa/ai

Supported providers

| Provider | Environment variable | |----------|---------------------| | Anthropic (Claude) | ANTHROPIC_API_KEY | | OpenAI | OPENAI_API_KEY | | Azure OpenAI | AZURE_OPENAI_API_KEY | | Ollama (local) | (none — set baseUrl) | | Any OpenAI-compatible | any key via config | | Null (no-op, for testing) | (none) |

Usage

import { createAiProvider } from '@apivexa/ai';

const provider = createAiProvider({
  provider: 'anthropic',
  model: 'claude-opus-5',
  apiKey: process.env.ANTHROPIC_API_KEY,
});

const response = await provider.complete({
  system: 'You are a technical writer.',
  prompt: 'Summarise this API in two sentences.',
  maxTokens: 256,
});

console.log(response.text);

Null provider (testing / offline)

const provider = createAiProvider({ provider: 'openai-compatible', model: 'none' });
// Returns empty strings — zero network calls, zero cost

Full documentation