文档 · 接入指南

Vercel AI SDK 接 TopxAI：createOpenAI、createAnthropic 和 openai-compatible

2026-09-19

用 baseURL https://ai.topxea.com/v1 和 TopxAI 密钥创建 AI SDK 供应商实例，然后用 generateText 或 streamText 调任意目录模型。

AI SDK 的供应商包都接受 baseURL，接 TopxAI 就是一个 create… 调用。

@ai-sdk/openai

import { createOpenAI } from '@ai-sdk/openai'
import { generateText } from 'ai'

const topxai = createOpenAI({
  baseURL: 'https://ai.topxea.com/v1',
  apiKey: process.env.TOPXAI_API_KEY,
})

const { text } = await generateText({
  model: topxai.chat('claude-sonnet-5-5'),
  prompt: 'Say hello in one sentence.',
})

topxai.chat(id) 走 Chat Completions，覆盖除 Jev 以外的全部文本模型。topxai.responses("gpt-6.1-sol") 走 Responses 接口，TopxAI 为 GPT 系列和 grok-4.7 提供。topxai.image("gpt-image-2.5-sunburst") 生成图像，按张计费。

@ai-sdk/anthropic

import { createAnthropic } from '@ai-sdk/anthropic'

const claude = createAnthropic({
  baseURL: 'https://ai.topxea.com/v1',
  apiKey: process.env.TOPXAI_API_KEY,
})

const { text } = await generateText({
  model: claude('claude-opus-5-5'),
  prompt: 'Say hello in one sentence.',
})

这个包的基础地址以 /v1 结尾（它自己拼 /messages），和 Anthropic 的 Python SDK 不同，后者填域名根。

@ai-sdk/openai-compatible

要一个不带 OpenAI 特有选项的供应商对象：

import { createOpenAICompatible } from '@ai-sdk/openai-compatible'

const topxai = createOpenAICompatible({
  name: 'topxai',
  baseURL: 'https://ai.topxea.com/v1',
  apiKey: process.env.TOPXAI_API_KEY,
})
const model = topxai('kimi-k3')

说明

streamText、工具调用、Output.object 结构化输出和直连官方端点一样。
结果里的 usage 是 TopxAI 返回的 token 数；实际扣费看用量日志。

不通时

401：密钥错了，或粘贴时带了空格。402：余额为零。403：这个模型 ID 不在售，或不在这把密钥的线路上。详见常见错误响应。
curl 能通、工具不通：这一页按工具列出常见原因。

模型：claude-sonnet-5-5, gpt-6.1-sol · 模型与价格

Vercel AI SDK 接 TopxAI：createOpenAI、createAnthropic 和 openai-compatible

@ai-sdk/openai

@ai-sdk/anthropic

@ai-sdk/openai-compatible

说明

不通时

相关