开发者文档

快速接入 AISAIL

AISAIL API 完全兼容 OpenAI 协议,只需修改 baseURL 和 apiKey ,即可将现有 AI 应用零成本迁移至 AISAIL,享受智能路由和多模型支持。

三步接入

01

获取 API Key

在 AISAIL 控制台创建 API Key

02

修改 baseURL

指向 https://token.jusuanta.com

03

选择模型

发送请求,智能路由自动分发

接入示例

Node.js — openai SDK
// 1. 安装依赖
// npm install openai
import OpenAI from "openai";
// 2. 初始化客户端
// 只需修改 baseURL 和 apiKey,其余与 OpenAI 官方用法一致
const client = new OpenAI({
baseURL: "https://token.jusuanta.com",
apiKey: "sk-tb-your-api-key-here",
});
// 3. 发起对话请求
async function chat() {
const response = await client.chat.completions.create({
model: "claude-sonnet-4-6",
messages: [
{ role: "system", content: "你是一个有帮助的助手。" },
{ role: "user", content: "介绍一下 AISAIL 平台" },
],
temperature: 0.7,
max_tokens: 1024,
});
console.log(response.choices[0].message.content);
}
chat();
// 4. 流式输出(Streaming)
async function chatStream() {
const stream = await client.chat.completions.create({
model: "gpt-4-turbo",
messages: [
{ role: "user", content: "讲一个关于AI的故事" },
],
stream: true,
});
for await (const chunk of stream) {
const content = chunk.choices[0]?.delta?.content || "";
process.stdout.write(content);
}
}
chatStream();

支持的模型

通过 GET /v1/models 可获取最新模型列表。示例如下,具体字段请以实际返回数据为准。

模型 ID提供商类型说明
claude-sonnet-4-6AnthropicChatClaude Sonnet 4.6,平衡性能与成本
claude-sonnet-4-5AnthropicChatClaude Sonnet 4.5,快速响应
gpt-4-turboOpenAIChatGPT-4 Turbo,高精度推理
gpt-4oOpenAIChatGPT-4o,多模态旗舰模型
gemini-2.5-proGoogleChatGemini 2.5 Pro,长上下文
gemini-2.5-flashGoogleChatGemini 2.5 Flash,极速响应
deepseek-chatDeepSeekChatDeepSeek Chat,高性价比
qwen-max阿里云Chat通义千问 Max,中文能力出色

请求参数

参数类型必填说明
modelstring是模型 ID,如 claude-sonnet-4-6
messagesarray是对话消息数组,每条包含 role 和 content
temperaturenumber否采样温度,0-2,默认 1
max_tokensnumber否最大输出 token 数
streamboolean否是否流式输出,默认 false
top_pnumber否核采样参数,0-1

注意事项

密钥安全

API Key 请妥善保管,切勿在客户端代码中暴露,建议通过后端代理转发请求。

传输加密

所有请求均通过 HTTPS 加密传输,确保数据在传输过程中的安全性。

协议兼容

流式响应使用 SSE(Server-Sent Events)协议,与 OpenAI 格式完全一致,无需额外适配。

错误处理

401 表示 API Key 无效,429 表示请求频率超限,请根据错误码调整重试策略。

自动容灾

AISAIL 会自动路由到最优模型提供商,如遇某 provider 故障将自动 failover,无需人工介入。

SDK 兼容

任意兼容 OpenAI 协议的 SDK 均可直接使用,无需安装额外依赖,零成本迁移。