通过统一接口调用多家主流大模型,支持文本对话、多模态理解、图像生成、流式输出等能力。 完全兼容 OpenAI、Anthropic、Google Gemini 原生协议。
核心能力
- 模型集成:聚合 GPT、Claude、Gemini、DeepSeek、Qwen、豆包、MiniMax 等数十个主流模型
- 多模态:文本、图像跨模态理解与生成
- 协议兼容:同时兼容 OpenAI Chat Completions、Anthropic Messages、Google Gemini 原生协议,已有 SDK 改 Base URL 即可接入
- 统一计费:所有模型按 Token / 次数统一计费,可在控制台看实时账单
- 流式输出:全面支持 Server-Sent Events (SSE) 流式响应
快速接入
只需两步即可完成接入:
登录 LeapX Hub 控制台,前往「令牌管理」创建你的 API Key。
按协议设置 Base URL:OpenAI SDK 用 https://hub.ai-leapx.com/v1,Anthropic SDK 用 https://hub.ai-leapx.com。在对应请求头中携带 API Key 即可。
base_url 设为 https://hub.ai-leapx.com/v1;Anthropic SDK 设为 https://hub.ai-leapx.com。把 api_key 替换为 LeapX API Key 即可,无需修改其他代码。
协议支持一览
| 协议 | 接口路径 | 适用场景 |
|---|---|---|
| OpenAI Chat | POST /v1/chat/completions | GPT、DeepSeek、Qwen 等 |
| Anthropic Messages | POST /v1/messages | Claude 系列模型 |
| OpenAI Images | POST /v1/images/generations | DALL·E、Stable Diffusion 等 |
| Embeddings | POST /v1/embeddings | 文本向量化 |
| Models | GET /v1/models | 查询可用模型列表 |
用 curl 验证 API Key 是否正常工作:
curl https://hub.ai-leapx.com/v1/chat/completions \ -H "Content-Type: application/json" \ -H "Authorization: Bearer YOUR_API_KEY" \ -d '{ "model": "gpt-5.1", "messages": [ {"role": "user", "content": "你好,介绍一下你自己"} ] }'
如果你用 Python OpenAI SDK:
from openai import OpenAI client = OpenAI( api_key="YOUR_API_KEY", base_url="https://hub.ai-leapx.com/v1" ) response = client.chat.completions.create( model="gpt-5.2-chat", messages=[ {"role": "user", "content": "你好!"} ] ) print(response.choices[0].message.content)
Node.js:
import OpenAI from 'openai'; const client = new OpenAI({ apiKey: 'YOUR_API_KEY', baseURL: 'https://hub.ai-leapx.com/v1' }); const response = await client.chat.completions.create({ model: 'gpt-5.2-chat', messages: [{ role: 'user', content: '你好!' }] }); console.log(response.choices[0].message.content);
stream = client.chat.completions.create(
model="gpt-5.2-chat",
messages=[{"role": "user", "content": "写一首诗"}],
stream=True
)
for chunk in stream:
if chunk.choices[0].delta.content:
print(chunk.choices[0].delta.content, end="", flush=True)
| 方法 | 路径 | 描述 |
|---|---|---|
| POST | /v1/chat/completions |
文本对话(OpenAI 兼容) |
| POST | /v1/messages |
文本对话(Anthropic 兼容) |
| GET | /v1/models |
获取可用模型列表 |
| POST | /v1/images/generations |
图像生成 |
| POST | /v1/embeddings |
文本向量化 |
| POST | /v1/audio/speech |
文字转语音 |
| POST | /v1/audio/transcriptions |
语音转文字 |
https://hub.ai-leapx.com/v1,请求头 Authorization: Bearer YOUR_API_KEY。Anthropic 协议 Base URL:https://hub.ai-leapx.com,请求头 x-api-key: YOUR_API_KEY。
获取 API Key
访问 hub.ai-leapx.com/panel 并登录你的账号。
在左侧菜单中找到「令牌管理」,点击「创建令牌」,设置名称和有效期,然后复制生成的 Key。
如何使用
在每个 API 请求的 Header 中携带:
Authorization: Bearer sk-leapx-xxxxxxxxxxxxxxxx
安全注意事项
- 不要将 API Key 硬编码在前端代码中,应通过后端代理请求
- 不要将 API Key 提交到 Git 等版本管理系统
- 建议为不同项目创建独立的 API Key,便于管控和撤销
- 如发现 Key 泄漏,立即在控制台「令牌管理」中禁用或删除
gpt-5.2-chat、claude-sonnet-4-6、deepseek-chat
role(system/user/assistant)和 content
false。设为 true 时使用 SSE 格式返回
示例请求
curl https://hub.ai-leapx.com/v1/chat/completions \ -H "Content-Type: application/json" \ -H "Authorization: Bearer YOUR_API_KEY" \ -d '{ "model": "gpt-5.2-chat", "messages": [ { "role": "system", "content": "你是一个专业的 AI 助手" }, { "role": "user", "content": "请用三句话介绍人工智能" } ], "temperature": 0.7, "max_tokens": 1024 }'
示例响应
{
"id": "chatcmpl-abc123",
"object": "chat.completion",
"created": 1749950000,
"model": "gpt-5.2-chat",
"choices": [
{
"index": 0,
"message": {
"role": "assistant",
"content": "人工智能是模拟人类智能的技术..."
},
"finish_reason": "stop"
}
],
"usage": {
"prompt_tokens": 32,
"completion_tokens": 128,
"total_tokens": 160
}
}
多模态(图像输入)
支持视觉能力的模型(如 gpt-5.2-chat、claude-sonnet-4-6)可以接收图像输入:
response = client.chat.completions.create(
model="gpt-5.2-chat",
messages=[
{
"role": "user",
"content": [
{"type": "text", "text": "这张图片里有什么?"},
{
"type": "image_url",
"image_url": {"url": "https://example.com/image.jpg"}
}
]
}
]
)
base_url 设为 https://hub.ai-leapx.com 即可,无需修改其他代码。
2023-06-01
claude-sonnet-4-6
user 或 assistant
1024
示例
import anthropic client = anthropic.Anthropic( api_key="YOUR_API_KEY", base_url="https://hub.ai-leapx.com" ) message = client.messages.create( model="claude-sonnet-4-6", max_tokens=1024, system="你是一个专业的 AI 助手", messages=[ {"role": "user", "content": "你好!"} ] ) print(message.content[0].text)
seedream-5.0-lite、seedream-5.0
url 返回图片链接(推荐);b64_json 返回 base64 编码
1024x1024、1792x1024、1024x1792
standard 或 hd,默认 standard
示例
response = client.images.generate(
model="seedream-5.0-lite",
prompt="一只猫坐在阳光下的窗台",
response_format="url"
)
print(response.data[0].url)
实战演示
下面是在 Apifox 工具中调用本接口的真实截图。填好地址、请求头与 JSON 请求体后点「发送」,即可在下方看到 200 成功响应和生成的图片链接。
STEP 1 · 发请求
接口地址
POST https://hub.ai-leapx.com/v1/videos
Headers — 必须带这两个
Authorization: Bearer YOUR_API_KEY Content-Type: application/json
YOUR_API_KEY。
Body — JSON 格式,最简只要三个字段
{
"model": "wan2.5-t2v-preview",
"prompt": "一只橘猫在窗台晒太阳",
"seconds": 5
}
| 字段 | 必填 | 说明 |
|---|---|---|
model | ✅ 必填 | 用哪个模型生成,见下方 ⑤ 模型表 |
prompt | ✅ 必填 | 描述画面内容,中英文均可 |
seconds | 可选 | 视频时长(秒),不填用模型默认;各模型可选档位见模型表 |
size | 可选 | 分辨率,如 1920x1080;不填默认 1280x720;VEO / 海螺不支持此参数 |
first_frame_url | 可选 | 首帧图片 URL,填了=图生视频;不填=纯文生视频 |
STEP 2 · 看响应,拿 content_url
发送成功(HTTP 200)后立刻返回,不用等视频生成完:
{
"id": "video_07a5c8210b1a471fb67e96e15400385b",
"status": "queued",
"content_url": "https://hub.ai-leapx.com/v1/videos/video_07a5c8.../content"
}content_url。复制这个链接,进入 STEP 3。
STEP 3 · 把 content_url 粘贴到浏览器
content_url 本身永久有效,可随时分享给别人。
④ 在代码里调用(复制即用)
import requests, time BASE = "https://hub.ai-leapx.com/v1" KEY = "YOUR_API_KEY" H = {"Authorization": f"Bearer {KEY}", "Content-Type": "application/json"} # 提交任务 task = requests.post(f"{BASE}/videos", headers=H, json={"model": "wan2.5-t2v-preview", "prompt": "一只橘猫在窗台晒太阳", "seconds": 5}).json() print("观看链接(可分享给任何人):", task["content_url"]) # 等待完成,拿最终地址(代码里需要时才用这段) while True: st = requests.get(f"{BASE}/videos/{task['id']}", headers=H).json() if st["status"] == "completed": break if st["status"] == "failed": raise Exception("生成失败,额度已退回") time.sleep(15) print("完成:", st["video_url"])
const BASE = "https://hub.ai-leapx.com/v1", KEY = "YOUR_API_KEY"; const H = { Authorization: `Bearer ${KEY}`, "Content-Type": "application/json" }; const task = await fetch(`${BASE}/videos`, { method: "POST", headers: H, body: JSON.stringify({ model: "wan2.5-t2v-preview", prompt: "一只橘猫在窗台晒太阳", seconds: 5 }) }).then(r => r.json()); console.log("观看链接:", task.content_url); let st; do { await new Promise(r => setTimeout(r, 15000)); st = await fetch(`${BASE}/videos/${task.id}`, { headers: H }).then(r => r.json()); if (st.status === "failed") throw new Error("生成失败,额度已退回"); } while (st.status !== "completed"); console.log("完成:", st.video_url);
⑤ 模型速查表
| model 值 | 来源 | 可选时长(秒) | 可选分辨率(size) |
|---|---|---|---|
wan2.5-t2v-preview | 阿里云 万相 | 5 / 10 | 1280x720(默认)/ 1920x1080 / 720x1280 |
doubao-seedance-2-0-260128 | 字节 火山 | 5 / 10 | 1280x720(默认)/ 960x960 / 720x1280 |
T2V-01-Director | MiniMax 海螺 | 6 / 10 | 固定 1280×720,不支持 size |
VQ3-Pro | Vidu | 5 / 8 | 1280x720(默认)/ 720x1280 / 960x960 |
veo-3.1-lite-generate-preview | Google VEO | 4 / 6 / 8 (只能这三档) | 固定输出,不支持 size |
語音合成內測中 — 該接口尚未對外開放,以下內容為預覽,正式開放後以本頁為準。
接口
POST https://hub.ai-leapx.com/v1/audio/speech
Headers — 必须带这两个
Authorization: Bearer YOUR_API_KEY Content-Type: application/json
Body — JSON 格式
{
"model": "speech-02-hd",
"input": "你好,欢迎使用 LeapX Hub 语音合成服务。",
"voice": "alloy",
"response_format": "mp3"
}
| 字段 | 必填 | 说明 |
|---|---|---|
model | ✅ 必填 | 见下方模型表 |
input | ✅ 必填 | 要合成的文字,中英文均可,最长 4096 字符 |
voice | ✅ 必填 | 音色,见下方音色表 |
response_format | 可选 | 输出格式:mp3(默认)/ opus / aac / flac |
speed | 可选 | 语速,0.25–4.0,默认 1.0 |
响应
HTTP 200,直接返回音频文件字节流(非 JSON),Content-Type 为 audio/mpeg。把响应体保存为 .mp3 即可播放。
代码示例(复制即用)
import requests response = requests.post( "https://hub.ai-leapx.com/v1/audio/speech", headers={ "Authorization": "Bearer YOUR_API_KEY", "Content-Type": "application/json", }, json={ "model": "speech-02-hd", "input": "你好,欢迎使用 LeapX Hub 语音合成服务。", "voice": "alloy", } ) with open("output.mp3", "wb") as f: f.write(response.content) print("已保存为 output.mp3")
const fs = require("fs"); const res = await fetch("https://hub.ai-leapx.com/v1/audio/speech", { method: "POST", headers: { Authorization: "Bearer YOUR_API_KEY", "Content-Type": "application/json", }, body: JSON.stringify({ model: "speech-02-hd", input: "你好,欢迎使用 LeapX Hub 语音合成服务。", voice: "alloy", }), }); fs.writeFileSync("output.mp3", Buffer.from(await res.arrayBuffer())); console.log("已保存为 output.mp3");
模型
| model 值 | 来源 | 特点 |
|---|---|---|
speech-02-hd | OpenAI | 高质量多语言,支持中文,延迟低,推荐首选 |
音色(voice)
| 值 | 风格 |
|---|---|
alloy | 中性自然 |
echo | 男声,低沉 |
fable | 男声,故事感 |
onyx | 男声,厚重 |
nova | 女声,温和 |
shimmer | 女声,明亮 |
通过 API 获取实时可用模型列表:
curl https://hub.ai-leapx.com/v1/models \
-H "Authorization: Bearer YOUR_API_KEY"
以下為精選速查。完整模型與實時價格(與計費同源)請見 模型與價格頁。
OpenAI GPT 系列
Anthropic Claude 系列
Google Gemini 系列
DeepSeek 系列
Qwen 通义千问
图像生成模型
GET /v1/models 可获取实时列表。
| HTTP 状态码 | 错误类型 | 原因与处理 |
|---|---|---|
400 | Bad Request | 请求参数格式错误,检查 JSON 结构和必填字段 |
401 | Unauthorized | API Key 无效或未提供,检查 Authorization Header |
403 | Forbidden | 账户余额不足或无权访问该模型 |
404 | Not Found | 请求路径或模型 ID 不存在 |
429 | Rate Limit | 请求频率超限,请降低请求频率或联系客服提升限额 |
500 | Server Error | 服务内部错误,可稍后重试 |
502 | Bad Gateway | 上游模型服务异常,可切换其他模型重试 |
错误响应格式
{
"error": {
"message": "Invalid API key provided",
"type": "invalid_request_error",
"code": "invalid_api_key"
}
}
重试建议
- 对于
429错误,建议使用指数退避策略重试(1s → 2s → 4s) - 对于
502/503错误,可立即重试 1-2 次,或切换备用模型 - 对于
401/403错误,无需重试,需先解决认证或余额问题