@ainative/next-sdk

用于 Next.js 的服务端 AINative 客户端，支持 App Router、流式聊天和认证中间件。

安装

bash
npm install @ainative/next-sdk

服务端客户端 — 聊天补全

typescript
// app/api/chat/route.ts
import { createServerClient } from @ainative/next-sdk/server;

export async function POST(request: Request) {
const { messages } = await request.json();

const client = createServerClient({
apiKey: process.env.AINATIVEAPIKEY!,
});

// 非流式
const result = await client.chat.completions.create({
model: claude-3-5-sonnet-20241022,
messages,
max_tokens: 1024,
});

return Response.json(result);
}

流式响应

typescript
// app/api/chat/route.ts
import { createServerClient } from @ainative/next-sdk/server;

export async function POST(request: Request) {
const { messages } = await request.json();

const client = createServerClient({ apiKey: process.env.AINATIVEAPIKEY! });

const stream = await client.chat.completions.create({
model: claude-3-5-sonnet-20241022,
messages,
stream: true,
});

return new Response(stream.body, {
headers: {
Content-Type: text/event-stream,
Cache-Control: no-cache,
},
});
}

认证中间件

typescript
// middleware.ts (仓库根目录或 src/)
import { createMiddleware } from @ainative/next-sdk/middleware;

export const middleware = createMiddleware({
apiKey: process.env.AINATIVEAPIKEY!,
protectedPaths: [/dashboard, /api/protected],
loginPath: /login,
publicPaths: [/, /about, /api/chat],
});

export const config = {
matcher: [/((?!next/static|next/image|favicon.ico).*)],
};

客户端（App Router）

typescript
// app/components/Chat.tsx
use client;
import { useState } from react;

export function Chat() {
const [messages, setMessages] = useState<{ role: string; content: string }[]>([]);
const [input, setInput] = useState();

const send = async () => {
const newMessages = [...messages, { role: user, content: input }];
setMessages(newMessages);
setInput();

const res = await fetch(/api/chat, {
method: POST,
headers: { Content-Type: application/json },
body: JSON.stringify({ messages: newMessages }),
});

const data = await res.json();
setMessages([...newMessages, data.choices[0].message]);
};

return (

Pages Router（API 路由）

typescript
// pages/api/chat.ts
import type { NextApiRequest, NextApiResponse } from next;
import { createServerClient } from @ainative/next-sdk/server;

export default async function handler(req: NextApiRequest, res: NextApiResponse) {
const client = createServerClient({ apiKey: process.env.AINATIVEAPIKEY! });

const result = await client.chat.completions.create({
model: claude-3-5-sonnet-20241022,
messages: req.body.messages,
});

res.json(result);
}

环境变量

bash

.env.local

切勿将 AINATIVEAPIKEY 暴露给客户端——仅在服务端代码中使用（路由处理器、Server Actions、getServerSideProps）。

导出

typescript
import { createServerClient } from @ainative/next-sdk/server;
import { createMiddleware } from @ainative/next-sdk/middleware;

参考

• - packages/sdks/nextjs/src/server/createServerClient.ts — 服务端客户端
• packages/sdks/nextjs/src/middleware/ — 认证中间件
• packages/sdks/nextjs/examples/app-router/ — 示例应用
• packages/sdks/nextjs/src/index.ts — 包导出