@ai-sdk/gateway 换成 @phaseo/ai-sdk-provider,并用 phaseo(...) 包裹每个模型 ID。在 OpenAI 兼容客户端中,更改 base URL 和密钥。生成逻辑保持不变。
切换 provider
phaseo 会在模块被导入时读取一次 PHASEO_API_KEY,并使用 https://api.phaseo.app/v1。如果该变量在导入之后才设置(某些 serverless 和测试环境就是这样),每次调用都会抛出缺少密钥的错误;这时请在处理函数内部调用 createPhaseo({ apiKey, baseURL, headers })。
安装与你的 ai 主版本匹配的 provider 版本线:AI SDK 7 用 @phaseo/ai-sdk-provider,AI SDK 6 用 @phaseo/ai-sdk-provider@ai-sdk-v6,AI SDK 5 用 @phaseo/ai-sdk-provider@ai-sdk-v5。
AI SDK 默认会通过 Vercel 的网关发送裸字符串模型(model: "openai/gpt-4.1-mini"),所以遗留的裸字符串会继续调用它。先修改共享的模型工厂,再在 AI SDK 调用中搜索 model: "。指向 ai-gateway.vercel.sh 的 Anthropic SDK 客户端改用从 Anthropic SDK 迁移中的配置。
映射网关选项
providerOptions.phaseo 会合并到请求体中。遗留的 providerOptions.gateway 会被忽略,不会报错。
测试并上线
用同一组提示词分别走两条路径,比较延迟、输出格式和 token 用量。提升流量之前确认:- 每个原先有网关密钥的运行时都设置了
PHASEO_API_KEY,包括 edge、服务器和预览部署; - 主要的文本生成路径和一个流式测试在预发布环境中无需改动即可通过;
- 如果应用用到工具调用和结构化输出,它们也要通过;
- 应用层的错误映射仍然有效;
- 预发布环境中的失败请求可以通过
GET /v1/generations?id=<request_id>找到,并在replay_supported为true时重放。