◑docsParity
vercel/ai★ 26,872TypeScript

vs https://ai-sdk.dev/docs/introduction

The scraped documentation is only the AI SDK introduction page, which contains almost no API reference detail; it therefore neither confirms nor contradicts the extracted API surface. The only concrete, verifiable mismatch is the introduction's illustrative example using a `model: "xai/grok-4.6"` string, since the code surface contains no evidence of such a model id (no versioned model identifiers are exposed). Beyond that, there is insufficient real documentation content provided to ground additional, actionable mismatches, so this audit should be considered low-yield rather than a clean bill of health.

0 high1 medium0 low
Open issue with all findings ↗
12
Files analyzed
116
API symbols
1
Doc pages
23.6s
Analyzed in
33%
API coverage: Poorly documented
38 of 116 exported symbols mentioned in docs
12 source files inspected · deepseek-chat · Sep 21, 2026

1 mismatch found

01

Intro example uses an unverifiable/incorrect xAI model id string

packages/ai/src/index.ts

medium
In the code
export { GatewayModelId } from '@ai-sdk/gateway'  // L5
In the docs
const { text } = await generateText({
  model: "xai/grok-4.6",
  prompt: "What is love?",
});

The introduction page's primary quick-start example passes a raw string model id `"xai/grok-4.6"`. The code surface exposes model ids only through the strongly-typed `GatewayModelId` union (re-exported from `@ai-sdk/gateway`), and the docs site itself lists the model as "Grok 4.6". A literal string bypasses that type check, so developers copying the snippet get no compile-time validation and may pass a model id string that the gateway does not recognize, causing a runtime model-not-found error. Because the provided code surface does not enumerate valid gateway model ids, this could not be confirmed as the canonical identifier.

Suggested fix
Update the introduction example to import the gateway and use a typed model id (e.g. `import { gateway } from 'ai'; model: gateway('xai/grok-4.6')`) or replace the string with a verified provider instance/model from the AI Gateway model list, so the snippet is type-checked and matches the actual available model ids.