跳转到主要内容

概述

类型: 框架或平台主要路径: 默认 OpenAI-compatible 路径支持级别: 推荐集成模式
对于 LemonData,Vercel AI SDK 中最稳定的默认选择是 OpenAI-compatible 提供方 如果你明确需要 Responses-native 行为,可以切换到 OpenAI 提供方,同时保持相同的 LemonData base URL。 请将本页视为推荐集成模式,而不是“仓库里对 Vercel AI SDK 每个 helper 都做了端到端回归”的声明。

推荐默认方案:OpenAI-compatible 提供方

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

export const lemondata = createOpenAICompatible({
  name: 'lemondata',
  apiKey: process.env.LEMONDATA_API_KEY,
  baseURL: 'https://api.lemondata.cc/v1',
});

生成文本

import { generateText } from 'ai';
import { lemondata } from './lemondata';

const { text } = await generateText({
  model: lemondata.chatModel('gpt-5.4'),
  prompt: 'Explain LemonData in one sentence.',
});

console.log(text);

流式文本

import { streamText } from 'ai';
import { lemondata } from './lemondata';

const result = await streamText({
  model: lemondata.chatModel('gpt-5.4'),
  prompt: 'Write a short poem about coding.',
});

for await (const textPart of result.textStream) {
  process.stdout.write(textPart);
}

工具调用

import { generateText, tool } from 'ai';
import { z } from 'zod';
import { lemondata } from './lemondata';

const result = await generateText({
  model: lemondata.chatModel('gpt-5.4'),
  prompt: 'What is the weather in San Francisco?',
  tools: {
    weather: tool({
      description: 'Get weather in a location',
      parameters: z.object({
        location: z.string(),
      }),
      execute: async ({ location }) => ({
        location,
        temperature: 72,
        condition: 'sunny',
      }),
    }),
  },
});

console.log(result.text);

结构化输出

import { generateObject } from 'ai';
import { z } from 'zod';
import { lemondata } from './lemondata';

const { object } = await generateObject({
  model: lemondata.chatModel('gpt-5.4'),
  schema: z.object({
    name: z.string(),
    role: z.string(),
  }),
  prompt: 'Generate a fake developer profile.',
});

console.log(object);

如果你明确需要 Responses-Native 行为

npm install ai @ai-sdk/openai
import { createOpenAI } from '@ai-sdk/openai';

export const lemondataResponses = createOpenAI({
  apiKey: process.env.LEMONDATA_API_KEY,
  baseURL: 'https://api.lemondata.cc/v1',
});
import { generateText } from 'ai';
import { lemondataResponses } from './lemondata-responses';

const { text } = await generateText({
  model: lemondataResponses('gpt-5.4'),
  prompt: 'Explain LemonData in one sentence.',
});
对于代理风格的集成,请将 @ai-sdk/openai-compatible 作为安全默认选择。仅当你明确希望使用基于 /v1/responses 构建的提供方路径时,才切换到 @ai-sdk/openai

环境变量

# .env.local
LEMONDATA_API_KEY=sk-your-lemondata-key

最佳实践

对于第三方网关和代理后端,@ai-sdk/openai-compatible 通常是最不容易产生意外的起点。
如果你需要与 /v1/responses 绑定的提供方行为,应有意识地切换提供方 package,而不是在同一个 client 中混用两种模式。
绝不要在客户端代码中暴露你的 LemonData API key。请将提供方配置放在服务器文件或 API 路由中。