在 Vercel AI Gateway 中,AI SDK 使用模型 ID openai/gpt-6.2-astra,并由团队的 AI_GATEWAY_API_KEY 鉴权;Gateway 负责向可用提供商路由请求。
适合的任务:通过 Vercel AI Gateway 在 AI SDK 应用中调用 GPT-6.2 Astra、配置推理档位或控制提供商路由。
不适合的任务:把此配置当作 OpenAI 直连 API 的鉴权方式或模型 ID。
适用的模型版本:GPT-6.2 Astra;页面还展示 openai/gpt-6.2-astra-fast 快速模式 ID。
适用的客户端、Agent 或 API:Vercel AI Gateway、AI SDK;页面也列出 Chat Completions、Responses API 和 Anthropic Messages API 入口。
推荐的推理档位和参数:按任务设置 reasoning(none、minimal、low、medium、high、xhigh);显式设置 maxOutputTokens 控制输出上限。
模型页的快速开始要求安装 AI SDK、创建 API key,并将其设为环境变量 AI_GATEWAY_API_KEY。密钥应放在服务端环境中,不要写入浏览器代码或提交到仓库。
pnpm add ai dotenv本地 .env:
AI_GATEWAY_API_KEY=你的_Vercel_AI_Gateway_API_Key在 Vercel 部署中,将同一变量配置到对应 Vercel Project 的 Environment Variables,并选择所需部署环境。页面说明 key 从 AI Gateway 的 API Keys 页面创建,调用用量计入团队,按 API 价格计费。
以下模型 ID 和参数格式来自模型页的 AI SDK 示例:
import { generateText } from 'ai';
const { text } = await generateText({
model: 'openai/gpt-6.2-astra',
system: 'You are a concise technical assistant.',
prompt: 'Summarize the tradeoffs between static generation and SSR.',
reasoning: 'high',
maxOutputTokens: 1024,
});流式调用使用同一个模型 ID:
import { streamText } from 'ai';
const result = streamText({
model: 'openai/gpt-6.2-astra',
prompt: 'Why is the sky blue?',
});Next.js Route Handler 可在服务端调用上述 SDK,例如 app/api/chat/route.ts 中导出 POST 并返回 result.toUIMessageStreamResponse()。这是应用层接入方式;Gateway key 仍由服务端环境变量提供。模型页没有规定 Next.js 路由结构或部署环境变量的管理步骤。
模型页示例通过 providerOptions.gateway 限制可用提供商:
const result = await generateText({
model: 'openai/gpt-6.2-astra',
prompt: 'Why is the sky blue?',
providerOptions: {
gateway: {
only: ['openai', 'bedrock'],
},
},
});路由参数:
only: string[]:硬性限制提供商;只在列表内尝试,列表内均不可用时请求失败。
order: string[]:优先尝试列出的提供商,列表外提供商仍可作为回退。
sort: 'cost' | 'ttft' | 'tps':按价格、首 token 延迟或生成速度排列候选提供商。
zeroDataRetention: boolean:仅路由到此模型具有零数据保留政策的提供商。
Gateway 路由选项放在 providerOptions.gateway;提供商原生选项放在相应命名空间中,具体支持项以 AI SDK 提供商文档为准。
在 Vercel AI Gateway 的 API Keys 页面为团队创建 key。
将 key 设为服务端环境变量 AI_GATEWAY_API_KEY;部署在 Vercel 时,在目标 Project 中配置对应环境。
安装 ai,在服务端用 openai/gpt-6.2-astra 调用 generateText 或 streamText。
需要约束路由时设置 providerOptions.gateway.only 或 order;不要把优先顺序误当成硬性白名单。
根据任务设置推理档位及输出上限,并在团队的 Gateway 计费口径下观察用量。
模型页顶部显示可用模型 ID openai/gpt-6.2-astra,代码示例使用 AI SDK 的 streamText。
Getting started 明确说明:创建 AI Gateway API key,将其设为 AI_GATEWAY_API_KEY;Gateway 对请求鉴权并路由到可用提供商。
Playground 说明用量计入团队并按 API 价格计费。页面显示输入价格 $8 / 1M tokens、输出价格 $40 / 1M tokens;这是采集时页面展示的价格,且提供商价格可能不同。
页面参数表显示上下文窗口为 1.1M tokens,最大输出为 128,000 tokens;prompt 与 response 共用上下文窗口,reasoning tokens 计入输出上限。
页面说明 AI SDK 7 或更新版本支持顶层 reasoning;提供商选项中的推理配置优先于顶层值。推理 token 通常计入输出用量,但各提供商报告与计费方式可能不同。
页面提供 -fast 后缀示例 openai/gpt-6.2-astra-fast,用于低延迟快速模式;页面未给出该模式与默认模式的量化对比。
这是 Vercel AI Gateway 的模型页配置。AI_GATEWAY_API_KEY 是 Gateway 凭据,不等于 OpenAI API key;模型页的调用目标是 Gateway 路由。
Vercel Project 用于部署应用及配置应用环境变量;模型页没有说明创建 Gateway key 与 Vercel Project 所属团队之间的全部权限、共享或访问控制规则。应在目标团队的 Gateway/API Keys 设置中核实。
若直接调用 OpenAI API,应使用 OpenAI 官方 SDK、凭据与模型 API 文档;此处的 Gateway 模型 ID 和环境变量不可直接照搬为 OpenAI 直连配置。
Next.js Route Handler 示例是应用端的接入位置说明,不是模型页提供的官方 Next.js 完整代码;必须从服务端调用,避免将 key 暴露给客户端。
价格、可用提供商和模型能力可能变化。本文只记录 2026-11-19 可见页面信息,不把实时 uptime 或吞吐指标当作长期保证。
在 Node.js 服务端安装 ai,设置有效的 AI_GATEWAY_API_KEY,运行上方 generateText 示例;需要流式输出时改用 streamText。请求成功与否还取决于 Gateway key 的团队权限、账户可用状态及所选路由提供商的可用性。本文未实际提交付费推理请求。
GPT-6.2 Astra