API REFERENCE
API REFERENCE
LeapX API 文档

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

BASE URL https://hub.ai-leapx.com/v1
📖
概述
了解 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 设置为 https://hub.ai-leapx.com/v1，在 Authorization 请求头中携带 API Key 即可。

💡 如果你已经在使用 OpenAI SDK，只需将 base_url 替换为 LeapX 地址，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-4o-mini",
    "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-4o",
    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-4o',
  messages: [{ role: 'user', content: '你好！' }]
});
console.log(response.choices[0].message.content);
4
开启流式输出
python
stream = client.chat.completions.create(
    model="gpt-4o",
    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 语音转文字
ℹ️ 所有请求的 Base URL 为 https://hub.ai-leapx.com，请求头需携带 Authorization: Bearer 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-4o、claude-sonnet-4-6、deepseek-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-4o",
    "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-4o",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "人工智能是模拟人类智能的技术..."
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 32,
    "completion_tokens": 128,
    "total_tokens": 160
  }
}

多模态（图像输入）

支持视觉能力的模型（如 gpt-4o、claude-sonnet-4-6）可以接收图像输入：

python
response = client.chat.completions.create(
    model="gpt-4o",
    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 为 user 或 assistant
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 必填 图像模型，例如 dall-e-3、dall-e-2
prompt string 必填 图像描述文本，最大 4000 字符
n integer 可选 生成数量，默认 1
size string 可选 图像尺寸，支持 1024x1024、1792x1024、1024x1792
quality string 可选 standard 或 hd，默认 standard

示例

python
response = client.images.generate(
    model="dall-e-3",
    prompt="一只金色的猫坐在云朵上，油画风格",
    n=1,
    size="1024x1024"
)
print(response.data[0].url)
🤖
模型列表
平台支持的全部 AI 模型

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

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

OpenAI GPT 系列

gpt-4o
文本视觉
gpt-4o-mini
文本视觉
gpt-4-turbo
文本视觉
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
文本视觉

图像生成模型

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 错误，无需重试，需先解决认证或余额问题
© 2025 LeapX Hub · 开发者文档 前往控制台 →