SDK
LangChain / SDK 接入
只要 SDK 支持 OpenAI Compatible Base URL,就可以接入 678API。
获取 LangChain SDK
安装与环境变量
npm install @langchain/openai
export API678_API_KEY="YOUR_API_KEY"LangChain JS 示例
import { ChatOpenAI } from "@langchain/openai";
const model = new ChatOpenAI({
apiKey: process.env.API678_API_KEY,
configuration: {
baseURL: "https://www.678api.com/v1",
},
model: "MODEL_ID_FROM_CONSOLE",
});直接使用 OpenAI SDK
import OpenAI from "openai";
const client = new OpenAI({
apiKey: process.env.API678_API_KEY,
baseURL: "https://www.678api.com/v1",
defaultHeaders: { "User-Agent": "678API-Node/1.0" },
});
const response = await client.chat.completions.create({
model: "MODEL_ID_FROM_CONSOLE",
messages: [{ role: "user", content: "Hello" }],
});上线前检查
- 将示例模型名替换为控制台实际可用的完整模型 ID。
- 为开发、测试、生产创建不同 API Key,并设置服务端请求超时和有限次数重试。
- 记录请求时间、模型名和错误码,但不要记录完整 API Key 或用户敏感内容。
- API Key 只能放在服务端;浏览器前端、桌面安装包和公开仓库都不能内置真实 Key。
常见问题
| 现象 | 检查方式 |
|---|---|
| SDK 自动请求官方 OpenAI | 确认使用的是 baseURL(JS)或 base_url(Python),并且值为 https://www.678api.com/v1。 |
| 浏览器出现 CORS | 不要让前端直接携带 Key 请求;通过自己的后端调用 678API。 |
| 工具调用参数不兼容 | 先用普通文本对话验证,再确认所选模型和线路支持 tools / function calling。 |
服务端调用建议
- API Key 放在服务端环境变量中。
- 为不同业务创建不同 Key,便于统计和停用。
- 对用户输入做必要的安全过滤和日志脱敏。