SPB Git

spb/polyllm

Public
2.5 KB

# Provider research — index

Last documentation audit: 2026-09-08

PolyLLM never relies on remembered API shapes. Before each adapter was written, the CURRENT official documentation was fetched and every claim that matters for the adapter was probed against the real API with the owner's keys. The per-provider reports below contain the base URLs, auth, SDKs and versions, streaming protocols and event names, tool/structured-output formats, reasoning controls, modalities, limits, parameter support matrices with exact rejection strings, error schemas, rate limits, pricing, lifecycle, and the probe scripts that produced the evidence.

Provider Report Model data SDK used Primary API Probe scripts
OpenAI openai.md openai.models.json (84) openai 7.10 Responses API (store:false, encrypted reasoning replay) research/openai/
Anthropic anthropic.md Models API (live capabilities) + src/lib/ai/providers/anthropic/catalog.ts (pricing) @anthropic-ai/sdk 0.124 Messages API (adaptive thinking, output_config) scripts/provider-matrix.ts
Google Gemini gemini.md gemini.models.json (19) @google/genai 2.21 generateContentStream (thinkingLevel/budget per family, thought signatures) research/gemini/
xAI xai.md xai.models.json (7) openai 7.10 with baseURL https://api.x.ai/v1 Chat Completions (+ /v1/responses for server-side web search) research/xai/

The verified behaviour is encoded in code, not prose:

  • src/lib/ai/providers/<provider>/catalog*.ts — capability sheets, parameter support, pricing, lifecycle.
  • src/lib/ai/providers/<provider>/index.ts — request translation that only sends what the model accepts.
  • docs/provider-test-matrix.md — generated by pnpm providers:matrix from live requests.

# Re-audit procedure (before every release)

  1. pnpm models:sync — refresh the registry from the live listing endpoints; check model_sync_runs for removed/added ids.
  2. Re-fetch the docs pages linked at the bottom of each report; update the catalog data when parameters, limits or prices moved.
  3. pnpm providers:matrix — must be all ✅; investigate any ❌ before shipping.
  4. Bump Last documentation audit in this file and in each report.
Files · 573449927df925a6fe97f81f5be20cd588e0a8dd
Menu

Theme