Vercel AI SDK priekš Grok
Šajā lapā
Atjaunināts 2026. gada 3. novembrī, pamatojoties uz AI SDK 7 un tā xAI nodrošinātāja dokumentāciju:
xai()izmanto Responses API, bet@ai-sdk/xainodrošinātāja 5. versija vairs neatbalsta Chat Completions; Next.js maršruts atgriežcreateUIMessageStreamResponse, un attēlu ģenerēšana notiek caurgenerateImagearaspectRatio. Avoti: AI SDK, xAI nodrošinātājs · AI SDK, tērzēšanas robots.
Grok JavaScript ekosistēmā
Vercel AI SDK ir galvenais risinājums valodu modeļu integrēšanai JavaScript un TypeScript lietotnēs. xAI piedāvā speciālu nodrošinātāju (@ai-sdk/xai), kas integrējas natīvi ar SDK, nodrošinot vienmērīgu izstrādes pieredzi tīmekļa lietotnēs.
Instalācija
Instalē SDK un xAI nodrošinātāju:
npm install ai @ai-sdk/xai
Ja izmanto TypeScript ar validācijas shēmām (strukturēta izvade), pievieno Zod:
npm install ai @ai-sdk/xai zod
Konfigurācija
xAI nodrošinātājs automātiski nolasī XAI_API_KEY vides mainīgo. Izveido .env.local failu projekta saknē:
XAI_API_KEY=xai-your-key-here
Teksta ģenerēšana
Pamata lietojums ar generateText:
import { generateText } from 'ai';
import { xai } from '@ai-sdk/xai';
const { text } = await generateText({
model: xai('grok-4.7'),
prompt: 'Explain the concept of serverless in 3 sentences.',
});
console.log(text);
Ar sarunu vēsturi
import { generateText } from 'ai';
import { xai } from '@ai-sdk/xai';
const { text } = await generateText({
model: xai('grok-4.7'),
messages: [
{ role: 'system', content: 'You are a cloud architecture expert.' },
{ role: 'user', content: 'What are the benefits of serverless?' },
],
});
Straumēšana
Vercel AI SDK izceļas ar straumēšanu, kas ir īpaši noderīga reaģējošām lietotāja saskarnēm:
import { streamText } from 'ai';
import { xai } from '@ai-sdk/xai';
const result = streamText({
model: xai('grok-4.7'),
prompt: 'Write an introduction to RESTful APIs.',
});
for await (const chunk of result.textStream) {
process.stdout.write(chunk);
}
Responses API vai Chat Completions
Ar pašreizējām versijām (AI SDK 7 un @ai-sdk/xai 5) xai(model) izmanto xAI Responses API, ko xAI iesaka: visi iepriekš minētie piemēri jau to izmanto, un xai.responses(model) ļauj to norādīt eksplicīti. Nodrošinātājs vairs neatbalsta veco Chat Completions galapunktu kopš 5. versijas (2026. gada septembris); ja tas tev ir nepieciešams, izmanto OpenAI SDK, kas norādīts uz xAI (iepriekšējā nodarbība).
import { generateText } from 'ai';
import { xai } from '@ai-sdk/xai';
// Responses API: īsā forma vai eksplicīta
const { text } = await generateText({
model: xai('grok-4.7'),
prompt: 'Analyze the pros and cons of microservices.',
});
const explicit = await generateText({
model: xai.responses('grok-4.7'),
prompt: 'Same question, naming the API.',
});
Integrācija ar Next.js
Vercel AI SDK ir izstrādāts, lai vislabāk darbotos ar Next.js. Lūk, API maršruts ar straumēšanu formātā, ko sagaida useChat hooks no @ai-sdk/react:
// app/api/chat/route.ts
import {
convertToModelMessages,
createUIMessageStreamResponse,
streamText,
toUIMessageStream,
type UIMessage,
} from 'ai';
import { xai } from '@ai-sdk/xai';
export async function POST(req: Request) {
const { messages }: { messages: UIMessage[] } = await req.json();
const result = streamText({
model: xai('grok-4.7'),
messages: await convertToModelMessages(messages),
});
return createUIMessageStreamResponse({
stream: toUIMessageStream({ stream: result.stream }),
});
}
Vecais result.toDataStreamResponse() vairs nepastāv; result.toUIMessageStreamResponse() AI SDK 7 vēl darbojas, bet ir novecojis.
Attēlu ģenerēšana
xAI nodrošinātājs atbalsta arī attēlu ģenerēšanu, izmantojot generateImage:
import { generateImage } from 'ai';
import { xai } from '@ai-sdk/xai';
const { image } = await generateImage({
model: xai.image('grok-imagine-image'),
prompt: 'A futuristic city at sunset',
aspectRatio: '16:9',
});
xAI attēlu modelis nepieņem parametru size: izmanto aspectRatio.
Kad izvēlēties šo SDK
Vercel AI SDK ir skaidra izvēle, tiklīdz strādā JavaScript vai TypeScript tīmekļa vidē. Ja tava lietotne darbojas Next.js, Nuxt, SvelteKit vai līdzīgā ietvarā, tā iederēsies tieši tur, kur jau strādā, ar hookiem un komponentēm, kas paredzēti šīm vidēm. Tā redzamākā stiprā puse ir straumēšana uz pārlūkprogrammu: pakāpeniska atbilžu attēlošana, kas, rakstot kodu ar rokām, ir sarežģīta, šeit darbojas dažās rindiņās. Un tās vairāku nodrošinātāju abstrakcija (viena un tā pati API priekš OpenAI, Anthropic un xAI) padara to par labāko izvēli, ja vēlies spēt mainīt modeļus, nepārrakstot integrācijas slāni: xAI nodrošinātājs aizstāj citu ar vienu importa rindiņu.
Galvenās atziņas
- Instalē
aiun@ai-sdk/xai, lai iegūtu natīvu Grok atbalstu xai()nodrošinātājs automātiski nolasīXAI_API_KEY- Izmanto
generateTextpilnām atbildēm unstreamTextstraumēšanai xai()izmanto Responses API; nodrošinātājs vairs neatbalsta Chat Completions kopš 5. versijas