API REFERENCE
API REFERENCE
LeapX API 文档

通过统一接口调用多家主流大模型,支持文本对话、多模态理解、图像生成、流式输出等能力。 完全兼容 OpenAI、Anthropic、Google Gemini 原生协议。

OpenAI BASE URL https://hub.ai-leapx.com/v1
Anthropic BASE URL https://hub.ai-leapx.com
📖
概述
了解 LeapX Hub 平台的核心能力与接入方式

核心能力

  • 模型集成:聚合 GPT、Claude、Gemini、DeepSeek、Qwen、豆包、MiniMax 等数十个主流模型
  • 多模态:文本、图像跨模态理解与生成
  • 协议兼容:同时兼容 OpenAI Chat Completions、Anthropic Messages、Google Gemini 原生协议,已有 SDK 改 Base URL 即可接入
  • 统一计费:所有模型按 Token / 次数统一计费,可在控制台看实时账单
  • 流式输出:全面支持 Server-Sent Events (SSE) 流式响应

快速接入

只需两步即可完成接入:

1
获取 API Key

登录 LeapX Hub 控制台,前往「令牌管理」创建你的 API Key。

2
发起请求

按协议设置 Base URL:OpenAI SDKhttps://hub.ai-leapx.com/v1Anthropic SDKhttps://hub.ai-leapx.com。在对应请求头中携带 API Key 即可。

💡 如果你已经在使用 OpenAI SDK,将 base_url 设为 https://hub.ai-leapx.com/v1Anthropic SDK 设为 https://hub.ai-leapx.com。把 api_key 替换为 LeapX API Key 即可,无需修改其他代码。

协议支持一览

协议接口路径适用场景
OpenAI ChatPOST /v1/chat/completionsGPT、DeepSeek、Qwen 等
Anthropic MessagesPOST /v1/messagesClaude 系列模型
OpenAI ImagesPOST /v1/images/generationsDALL·E、Stable Diffusion 等
EmbeddingsPOST /v1/embeddings文本向量化
ModelsGET /v1/models查询可用模型列表
快速开始
5 分钟完成第一次 API 调用
1
获取 API Key

登录 控制台 → 「令牌管理」→「创建令牌」,复制生成的 API Key。

⚠️ API Key 只会显示一次,请妥善保存。如果丢失需重新创建。
2
发送第一个请求

用 curl 验证 API Key 是否正常工作:

bash
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": "你好,介绍一下你自己"}
    ]
  }'
3
用 SDK 接入(推荐)

如果你用 Python OpenAI SDK:

python
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:

javascript
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);
4
开启流式输出
python
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)
如果响应正常返回,说明接入成功!查看 模型列表 了解所有可用模型。
🗂️
端点速览
所有可用 API 端点一览
方法路径描述
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 语音转文字
ℹ️ OpenAI 协议 Base URL:https://hub.ai-leapx.com/v1,请求头 Authorization: Bearer YOUR_API_KEYAnthropic 协议 Base URL:https://hub.ai-leapx.com,请求头 x-api-key: YOUR_API_KEY
🔐
认证与密钥
如何获取并使用 API Key

获取 API Key

1
登录控制台

访问 hub.ai-leapx.com/panel 并登录你的账号。

2
创建令牌

在左侧菜单中找到「令牌管理」,点击「创建令牌」,设置名称和有效期,然后复制生成的 Key。

如何使用

在每个 API 请求的 Header 中携带:

http
Authorization: Bearer sk-leapx-xxxxxxxxxxxxxxxx

安全注意事项

  • 不要将 API Key 硬编码在前端代码中,应通过后端代理请求
  • 不要将 API Key 提交到 Git 等版本管理系统
  • 建议为不同项目创建独立的 API Key,便于管控和撤销
  • 如发现 Key 泄漏,立即在控制台「令牌管理」中禁用或删除
⚠️ API Key 代表你的账户权限,消耗的 Token 将从你的余额中扣除,请妥善保管。
💬
Chat Completions
OpenAI 兼容的对话接口,支持所有主流模型
POST /v1/chat/completions 创建对话补全
请求参数(Body · JSON)
model string 必填 模型 ID,例如 gpt-5.2-chatclaude-sonnet-4-6deepseek-chat
messages array 必填 对话消息列表,每条消息包含 role(system/user/assistant)和 content
stream boolean 可选 是否启用流式输出,默认 false。设为 true 时使用 SSE 格式返回
temperature number 可选 采样温度,范围 0-2。值越高输出越随机,越低越确定。默认 1
max_tokens integer 可选 最大输出 Token 数量。不设置则使用模型默认值
top_p number 可选 核采样概率,范围 0-1,通常不与 temperature 同时调整

示例请求

curl
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
  }'

示例响应

json
{
  "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-chatclaude-sonnet-4-6)可以接收图像输入:

python
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"}
                }
            ]
        }
    ]
)
📨
Messages(Anthropic 兼容)
使用 Anthropic 原生协议调用 Claude 系列模型
ℹ️ 如果你已在使用 Anthropic Python SDK,只需将 base_url 设为 https://hub.ai-leapx.com 即可,无需修改其他代码。
POST /v1/messages Anthropic Messages API
请求头
x-api-key string 必填 你的 LeapX API Key
anthropic-version string 必填 填写 2023-06-01
请求参数
model string 必填 模型 ID,例如 claude-sonnet-4-6
messages array 必填 消息列表,role 为 userassistant
max_tokens integer 必填 最大输出 Token 数,例如 1024
system string 可选 系统提示词

示例

python
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)
🖼️
图片生成
OpenAI 兼容的图像生成接口
POST /v1/images/generations 生成图像
model string 必填 图像生成模型,例如 seedream-5.0-liteseedream-5.0
prompt string 必填 图像描述文本,最大 4000 字符
response_format string 可选 url 返回图片链接(推荐);b64_json 返回 base64 编码
n integer 可选 生成数量,默认 1
size string 可选 图像尺寸,支持 1024x10241792x10241024x1792
quality string 可选 standardhd,默认 standard

示例

python
response = client.images.generate(
    model="seedream-5.0-lite",
    prompt="一只猫坐在阳光下的窗台",
    response_format="url"
)
print(response.data[0].url)

实战演示

下面是在 Apifox 工具中调用本接口的真实截图。填好地址、请求头与 JSON 请求体后点「发送」,即可在下方看到 200 成功响应和生成的图片链接。

Apifox 请求体与成功响应
① 请求体(Body → JSON):填入 model、prompt、response_format,发送后返回 200 与图片 url
Apifox 请求头设置
② 请求头(Headers):Content-Type: application/json,Authorization: Bearer 你的 API Key
🎬
视频生成
发一个请求,等 1–3 分钟,粘贴链接看视频。
STEP 1
发请求
POST /v1/videos
填好 Header + Body
STEP 2
拿 content_url
响应里即有链接
无需额外操作
STEP 3
粘贴到浏览器
自动等待 → 生成完
自动播放 / 下载

STEP 1 · 发请求

接口地址

http
POST https://hub.ai-leapx.com/v1/videos

Headers — 必须带这两个

http
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json
Apifox Headers 填写示例
▲ 在 Apifox / Postman 的 Headers 里填上这两项(实际截图)
🔑 API Key 在哪? 登录 hub.ai-leapx.com → 右上角头像 → API 密钥,复制密钥替换 YOUR_API_KEY

Body — JSON 格式,最简只要三个字段

json
{
  "model":   "wan2.5-t2v-preview",
  "prompt":  "一只橘猫在窗台晒太阳",
  "seconds": 5
}
Apifox Body 填写与响应示例
▲ Body 选 JSON,填完点发送,下方 200 表示成功,响应里拿 content_url(实际截图)
字段必填说明
model✅ 必填用哪个模型生成,见下方 ⑤ 模型表
prompt✅ 必填描述画面内容,中英文均可
seconds可选视频时长(秒),不填用模型默认;各模型可选档位见模型表
size可选分辨率,如 1920x1080;不填默认 1280x720;VEO / 海螺不支持此参数
first_frame_url可选首帧图片 URL,填了=图生视频;不填=纯文生视频

STEP 2 · 看响应,拿 content_url

发送成功(HTTP 200)后立刻返回,不用等视频生成完

json 响应示例
{
  "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 粘贴到浏览器

生成中
显示等待页,每 15 秒自动检查一次进度
▶️
生成完成
自动跳播放器,在线看 + 一键下载
生成失败
显示失败提示,额度已自动全额退回
⚠️ 上游视频直链有效期约 5–24 小时,如需保存请及时下载。content_url 本身永久有效,可随时分享给别人。

④ 在代码里调用(复制即用)

python
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"])
node.js
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 / 101280x720(默认)/ 1920x1080 / 720x1280
doubao-seedance-2-0-260128字节 火山5 / 101280x720(默认)/ 960x960 / 720x1280
T2V-01-DirectorMiniMax 海螺6 / 10固定 1280×720,不支持 size
VQ3-ProVidu5 / 81280x720(默认)/ 720x1280 / 960x960
veo-3.1-lite-generate-previewGoogle VEO4 / 6 / 8 (只能这三档)固定输出,不支持 size
💡 计费:按模型 + 时长固定收费,生成成功才扣,失败全额退回。提交时先冻结额度,账户余额即可用上限。
🔊
语音合成(TTS)
把文字变成 MP3 语音,一个请求即刻返回音频文件。

語音合成內測中 — 該接口尚未對外開放,以下內容為預覽,正式開放後以本頁為準。

接口

http
POST https://hub.ai-leapx.com/v1/audio/speech

Headers — 必须带这两个

http
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json
Apifox Headers 填写示例
▲ 在 Apifox / Postman 的 Headers 里填上这两项(实际截图)

Body — JSON 格式

json
{
  "model":           "speech-02-hd",
  "input":           "你好,欢迎使用 LeapX Hub 语音合成服务。",
  "voice":           "alloy",
  "response_format": "mp3"
}
Apifox Body 填写与响应示例
▲ Body 选 JSON,填完点发送,200 表示成功,响应为 audio/mpeg 音频文件(实际截图)
字段必填说明
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 即可播放。

代码示例(复制即用)

python
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")
node.js
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-hdOpenAI高质量多语言,支持中文,延迟低,推荐首选

音色(voice)

风格
alloy中性自然
echo男声,低沉
fable男声,故事感
onyx男声,厚重
nova女声,温和
shimmer女声,明亮
🤖
模型列表
平台支持的全部 AI 模型

通过 API 获取实时可用模型列表:

bash
curl https://hub.ai-leapx.com/v1/models \
  -H "Authorization: Bearer YOUR_API_KEY"

以下為精選速查。完整模型與實時價格(與計費同源)請見 模型與價格頁

OpenAI GPT 系列

gpt-5.2-chat
文本视觉
gpt-5.1
文本视觉
gpt-5.3-chat
文本视觉
o1
推理
o1-mini
推理
o3-mini
推理

Anthropic Claude 系列

claude-opus-4-8
文本视觉
claude-sonnet-4-6
文本视觉
claude-haiku-4-5
文本视觉

Google Gemini 系列

gemini-2.0-flash
文本视觉
gemini-1.5-pro
文本视觉
gemini-1.5-flash
文本

DeepSeek 系列

deepseek-chat
文本
deepseek-reasoner
推理

Qwen 通义千问

qwen-max
文本
qwen-plus
文本
qwen-turbo
文本
qwen-vl-max
文本视觉

图像生成模型

seedream-5.0-lite
图像
seedream-5.0
图像
seedream-4.5
图像
seedream-4.0
图像
seedream-3.0
图像
dall-e-3
图像
dall-e-2
图像
ℹ️ 以上为常用模型列表,实际可用模型以控制台「渠道管理」中配置的为准。调用 GET /v1/models 可获取实时列表。
⚠️
错误码说明
常见错误及处理方法
HTTP 状态码错误类型原因与处理
400Bad Request请求参数格式错误,检查 JSON 结构和必填字段
401UnauthorizedAPI Key 无效或未提供,检查 Authorization Header
403Forbidden账户余额不足或无权访问该模型
404Not Found请求路径或模型 ID 不存在
429Rate Limit请求频率超限,请降低请求频率或联系客服提升限额
500Server Error服务内部错误,可稍后重试
502Bad Gateway上游模型服务异常,可切换其他模型重试

错误响应格式

json
{
  "error": {
    "message": "Invalid API key provided",
    "type": "invalid_request_error",
    "code": "invalid_api_key"
  }
}

重试建议

  • 对于 429 错误,建议使用指数退避策略重试(1s → 2s → 4s)
  • 对于 502 / 503 错误,可立即重试 1-2 次,或切换备用模型
  • 对于 401 / 403 错误,无需重试,需先解决认证或余额问题