AGENT PULSESJCPal Special EditionAI Industry Evidence & Trends
Aug 17, 2026 · @ai-sdk/openai-compatible

@ai-sdk/openai-compatible@3.0.31

What Happened

Vercel AI SDK 发布 @ai-sdk/openai-compatible@3.0.31,修复了 usage.raw 中嵌套字段(prompt_tokens_details 和 completion_tokens_details)被严格解析导致丢失的问题,现在这些字段被宽松解析,保留 provider 返回的额外信息。

EVENT STORY

Development

  1. First Report@ai-sdk/huggingface@2.0.31Vercel AI SDK
  2. Industry Response@ai-sdk/openai-compatible@3.0.31Vercel AI SDK
  3. Current Assessment该修复反映了 AI 工具链在标准化与灵活性之间的平衡。SDK 需要提供统一的接口,同时保留 provider 的差异化能力。这可能导致更多 SDK 采用宽松解析策略,以支持多样化的 provider 特性。Agent Pulse · analysis
What Changed

Vercel AI SDK 的 @ai-sdk/openai-compatible@3.0.31 版本修复了一个关于 usage 字段解析的问题。此前,usage.raw 被设计为保留 provider 返回的原始 usage 形状,但嵌套的 prompt_tokens_details 和 completion_tokens_details 对象被严格解析,导致 provider 在这些对象中提供的额外字段(如 audio_tokens、image_tokens、text_tokens)被丢弃。此次更新将这两个嵌套对象改为宽松解析,同时 completion 模型的 usage schema 也进行了相应调整。该修复仅影响 usage.raw,映射的 token 计数不受影响。

How the Capability Boundary Shifted

此修复表明 AI SDK 在 usage 数据解析上从严格模式转向宽松模式,以保留 provider 特有的 usage 细节。对于依赖 usage.raw 进行成本分析或监控的开发者,这意味着可以获取更完整的 token 使用信息。未来可关注 SDK 是否会将更多 provider 特有字段纳入标准映射。

Why It Matters

该修复反映了 AI 工具链在标准化与灵活性之间的平衡。SDK 需要提供统一的接口,同时保留 provider 的差异化能力。这可能导致更多 SDK 采用宽松解析策略,以支持多样化的 provider 特性。

Who It Affects

对于使用 Vercel AI SDK 的企业,此修复提高了 usage 数据的完整性,有助于更精确的成本核算和资源优化。开发者可以基于更详细的 token 使用情况调整模型调用策略,降低运营成本。

What to Watch Next

未来,AI SDK 可能会进一步扩展 usage 字段的映射,或提供更细粒度的配置选项,让开发者选择严格或宽松解析。同时,provider 可能会在 usage 中提供更多自定义字段,推动 SDK 持续更新。