LeapX Hub · API 接入文档

📖概述

LeapX 是一站式大模型 API 平台，聚焦"降低模型应用门槛，加速场景智能化"。通过标准化接口与模块化组件，将复杂的模型技术转化为可快速集成的能力积木。

核心能力

模型集成：聚合 GPT、Claude、Gemini、DeepSeek、Qwen、豆包、MiniMax、即梦、VEO、DALL·E 等数十个主流模型
多模态：文本、图像、音频、视频跨模态理解与生成
协议兼容：同时兼容 OpenAI、Anthropic Messages、Google Gemini 原生协议，已有 SDK 改 Base URL 即可接入
统一计费：所有模型按 Token / 次数统一计费，可在控制台查看实时账单

典型场景

内容创作：新闻报道、商品介绍、短视频脚本自动生成
智能客服：24 小时多轮问答、知识库问答
文本翻译：多语言互译、本地化
摘要生成：长文档、邮件、会议纪要自动摘要
图像/视频理解：图像识别、视频分析、文档 OCR
图像/视频/音频生成：文生图、文生视频、语音合成

🚀快速开始

三步开始调用

注册账号：访问 ai-leapx.com，使用手机号验证码完成注册，新用户可领代金券。
开通模型：在控制台「模型广场」选择需要的模型，开通按量付费或购买量包。
创建 API Key：进入「API Key 管理」创建专属 Key，用于接口鉴权。

接入信息

项目	值
Base URL	`https://hub.ai-leapx.com/v1`
Chat 接口	`https://hub.ai-leapx.com/v1/chat/completions`
鉴权方式	`Authorization: Bearer ${API_KEY}`（Anthropic 原生使用 `x-api-key`；Gemini 原生使用 `x-goog-api-key`，也兼容 `?key=`）
请求类型	`Content-Type: application/json`

第一次调用

cURL

curl https://hub.ai-leapx.com/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer leapx_api_key" \
  -d '{
    "model": "gpt-5.6-luna",
    "messages": [
      {"role": "user", "content": "你好"}
    ]
  }'

Python (openai)

# pip install openai
from openai import OpenAI

client = OpenAI(
    api_key="YOUR_LEAPX_API_KEY",
    base_url="https://hub.ai-leapx.com/v1",
)

resp = client.chat.completions.create(
    model="gpt-5.6-luna",
    messages=[{"role": "user", "content": "你好"}],
)
print(resp.choices[0].message.content)

Node.js (openai)

// npm i openai
import OpenAI from "openai";

const client = new OpenAI({
  apiKey: process.env.LEAPX_API_KEY,
  baseURL: "https://hub.ai-leapx.com/v1",
});

const resp = await client.chat.completions.create({
  model: "gpt-5.6-luna",
  messages: [{ role: "user", content: "你好" }],
});
console.log(resp.choices[0].message.content);

提示：LeapX 完全兼容 OpenAI SDK，只需把 base_url 改为 https://hub.ai-leapx.com/v1，API Key 换为 LeapX Key，即可在保持原代码不变的前提下调用所有 OpenAI 兼容模型。

🔀调用协议怎么选

同一个 LeapX API Key 可以调用模型广场中已开通的模型。模型名必须使用「模型广场」或 GET /v1/models 返回的公开 ID；请勿使用供应商内部模型名、渠道前缀或内部后缀。

最简单的选择：文本和多模态对话优先使用 /v1/chat/completions；所有图片模型都可使用 /v1/images/generations；视频模型使用 /v1/videos。需要完全保持厂商原生请求体时，再选 Anthropic Messages 或 Google Gemini 原生接口。

需求	协议与端点	关键字段 / 鉴权
通用文本、多模态对话	`POST /v1/chat/completions`	`model`、`messages`；Bearer Key
OpenAI Responses 原生	`POST /v1/responses`	`model`、`input`；Bearer Key
Anthropic Messages 原生	`POST /v1/messages`	`model`、`messages`、`max_tokens`；`x-api-key`
Google Gemini 原生	`POST /v1beta/models/{model}:generateContent`	`contents`；`x-goog-api-key`
所有图片模型（统一入口）	`POST /v1/images/generations`	顶层 `model`、非空 `prompt`；Bearer Key
Gemini / Nano Banana 图片原生	`POST /v1beta/models/{model}:generateContent`	`contents`、`generationConfig.responseModalities`
视频生成	`POST /v1/videos`	顶层 `model`、`prompt`、`seconds`、`size`；Bearer Key

不要混用请求体：/v1/images/generations 读取顶层 prompt，Gemini 原生接口读取 contents[].parts[].text，/v1/videos 读取顶层扁平字段。将一种协议的请求体提交到另一种端点，会出现「描述内容不能为空」或「请求体解析失败」。

Anthropic Messages 支持图片输入理解，不提供图片生成输出；需要生成图片时请使用图片统一入口或 Gemini 图片原生接口。

🧭端点速览

下表列出 LeapX 提供的全部 API 端点，按类别分组：

文本生成

方法	路径	说明
POST	`/v1/chat/completions`	OpenAI 兼容的对话/多模态接口（推荐）
POST	`/v1/responses`	OpenAI Responses API（GPT 系列）
POST	`/v1/messages`	Anthropic Messages 协议（Claude 等）
POST	`/v1beta/models/{model}:generateContent`	Google Gemini 原生协议
POST	`/v1beta/models/{model}:streamGenerateContent`	Gemini 流式

图片生成

方法	路径	说明
POST	`/v1/images/generations`	文生图（OpenAI 兼容）
POST	`/v1/images/edits`	图生图/图片编辑（OpenAI 兼容）
POST	`/v1beta/models/{model}:generateContent`	Gemini 图片生成（Nano Banana 等）

音频与视频

方法	路径	说明
POST	`/v1/audio/speech`	语音合成（TTS）
POST	`/v1/videos`	视频生成（LeapX 公开扁平格式）
GET	`/v1/videos/{video_id}`	查询视频生成状态
GET	`/v1/videos/{video_id}/content`	下载视频结果

平台

方法	路径	说明
GET	`/v1/models`	列出可用模型
GET	`/openApi/queryModelBill`	查询用量账单（AccessKey 签名鉴权）

💬Chat Completions

POST https://hub.ai-leapx.com/v1/chat/completions

OpenAI 兼容的对话/多模态接口，支持文本生成、图像理解、视频理解、音频处理、工具调用、流式输出等能力。适用于 GPT、Claude、Gemini、DeepSeek、Qwen、豆包等几乎所有模型。

典型应用：

内容创作：新闻报道、商品介绍、短视频脚本
客户服务：24 小时智能客服、常见问题解答
文本翻译：多语言互译
摘要生成：长篇文章、报告、邮件自动摘要
图片/视频理解：识别图像内容、描述场景、分类打标

入参参数

参数	说明	必填	类型
model	模型 ID	必填	String
messages	聊天上下文信息（详见下方 Messages 参数说明），包含从头到尾的对话历史	必填	Array
max_tokens	本次请求返回的最大 Token 数（Claude 模型必填）	可选	Integer
temperature	影响输出多样性，取值 [0.0, 2.0]。较高值更随机，较低值更确定。模型有默认推荐值，不推荐修改。	可选	Float
top_p	影响输出多样性，取值 [0.0, 1.0]。值越大多样性越强。模型有默认推荐值，不推荐修改。	可选	Float
stream	是否使用流式接口。`true` 流式 / `false` 非流式（默认 false）	可选	Boolean
思考参数	各模型厂商思考参数不同，详见下方思考参数说明	可选	—

示例代码（多模态 + 流式）

调用多模态模型描述图片内容（流式输出）：

cURL

curl --location 'https://hub.ai-leapx.com/v1/chat/completions' \
  --header "Authorization: Bearer API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
  "model": "qwen-vl-max",
  "messages": [
    {
      "role": "system",
      "content": [{"type": "text", "text": "You are a helpful assistant."}]
    },
    {
      "role": "user",
      "content": [
        {
          "type": "image_url",
          "image_url": {
            "url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20241022/emyrja/dog_and_girl.jpeg"
          }
        },
        {"type": "text", "text": "图中描绘的是什么景象?"}
      ]
    }
  ],
  "stream": true
}'

返回参数

参数	说明	类型
created	Unix 时间戳（秒），示例：1705634032	Integer
model	模型 ID	String
usage	Token 统计：prompt_tokens / completion_tokens / total_tokens（按总 Token 计费）	Object
choices	回复内容列表（详见下方 choices 说明）	Array

choices 字段

通常只含一个元素（n=1 时），每个元素包含：

字段	说明	类型
index	在 choices 中的索引，通常为 0	Integer
finish_reason	`stop` 自然停止 / `length` 达到最大 Token / `content_filter` 内容过滤 / `tool_calls` 工具调用	String
message	模型生成的消息，含 content / role / tool_calls	Object
delta	流式返回时的增量内容	Object

返回示例

JSON

{
  "choices": [
    {
      "delta": {
        "content": "这张图片展示了一位女士和一只狗在海滩上互动...",
        "role": "assistant"
      },
      "finish_reason": "stop",
      "index": 0,
      "logprobs": null
    }
  ],
  "object": "chat.completion",
  "usage": {
    "prompt_tokens": 1270,
    "completion_tokens": 54,
    "total_tokens": 1324
  },
  "created": 1725948561,
  "model": "qwen-vl-max",
  "id": "chatcmpl-0fd66f46-b09e-9164-a84f-3ebbbedbac15"
}

JSON

{
  "choices": [
    {
      "message": {
        "content": "这张图片展示了一位女士和一只狗在海滩上互动...",
        "role": "assistant"
      },
      "finish_reason": "stop",
      "index": 0,
      "logprobs": null
    }
  ],
  "object": "chat.completion",
  "usage": {
    "prompt_tokens": 1270,
    "completion_tokens": 54,
    "total_tokens": 1324
  },
  "created": 1725948561,
  "model": "qwen-vl-max",
  "id": "chatcmpl-0fd66f46-b09e-9164-a84f-3ebbbedbac15"
}

🧩Responses

POST https://hub.ai-leapx.com/v1/responses

Responses API 是 OpenAI 最新推出的接口，原生支持高效的上下文管理，延续了 Chat API 的易用性，并提供模型的有状态交互——将先前响应的输出用作输入。支持函数调用、MCP 调用等扩展能力。

前提条件：获取 API Key、开通模型服务，仅支持 GPT 系列模型。相关指南可参阅 OpenAI 官网。

普通对话

cURL · 请求

curl --location --request POST 'https://hub.ai-leapx.com/v1/responses' \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer ${API_KEY}' \
  --data-raw '{
    "model": "gpt-5.6-luna",
    "input": "你好"
  }'

JSON · 响应

{
  "id": "resp_68b65ed1a3208191b78047adad685c8b0f24654d3ee42629",
  "object": "response",
  "status": "completed",
  "model": "gpt-5.6-luna",
  "output": [
    {
      "id": "msg_...",
      "type": "message",
      "status": "completed",
      "content": [
        {"type": "output_text", "annotations": [], "text": "你好！有什么我可以帮你的吗？"}
      ],
      "role": "assistant"
    }
  ],
  "usage": {
    "input_tokens": 8,
    "output_tokens": 10,
    "total_tokens": 18
  },
  "created_at": 1756782289
}

图片分析

cURL · 请求

curl --location --request POST 'https://hub.ai-leapx.com/v1/responses' \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer ${API_KEY}' \
  --data-raw '{
    "input": [
      {
        "role": "user",
        "content": [
          {"type": "input_text", "text": "描述这张图片中的内容"},
          {"type": "input_image", "image_url": "https://example.com/image_1.png"}
        ]
      }
    ],
    "stream": false,
    "model": "gpt-5.6-luna"
  }'

流式响应

cURL · 请求

curl --location --request POST 'https://hub.ai-leapx.com/v1/responses' \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer ${API_KEY}' \
  --data-raw '{
    "model": "gpt-5.6-luna",
    "instructions": "你是一个有帮助的助手。",
    "input": "你好",
    "stream": true
  }'

SSE 事件序列：response.created → response.in_progress → response.output_item.added → response.output_text.delta（多次）→ response.output_text.done → response.content_part.done → response.output_item.done → response.completed。

函数调用

cURL · 请求

curl --location --request POST 'https://hub.ai-leapx.com/v1/responses' \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer ${API_KEY}' \
  --data-raw '{
    "input": [{"content": "今天合肥的天气怎么样", "role": "user"}],
    "stream": false,
    "model": "gpt-5.6-luna",
    "tools": [
      {
        "name": "get_the_weather_info",
        "description": "get the weather info",
        "type": "function",
        "parameters": {
          "type": "object",
          "properties": {
            "city": {"description": "the city name", "type": "string"},
            "day":  {"description": "the day", "type": "string"}
          },
          "required": ["city"]
        }
      }
    ]
  }'

MCP 调用

cURL · 请求

curl --location --request POST 'https://hub.ai-leapx.com/v1/responses' \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer ${API_KEY}' \
  --data-raw '{
    "input": [{"content": "今天合肥的天气怎么样", "role": "user"}],
    "model": "gpt-responses",
    "stream": false,
    "tools": [
      {
        "server_label": "amap",
        "require_approval": "never",
        "server_url": "https://mcp.amap.com/mcp?key=**************",
        "type": "mcp"
      }
    ]
  }'

📨Messages

POST https://hub.ai-leapx.com/v1/messages

Anthropic Messages 协议。给定一组包含文本和/或图像内容的结构化输入消息列表，模型将生成对话中的下一条消息。Messages API 可用于单次查询或无状态的多轮对话。

支持模型：Claude 系列、MiniMax M2 系列、doubao-seed-code 系列、智谱 GLM 4.6 / 4.7 / GLM-5 旗舰系列。

鉴权方法

请求头使用 x-api-key，并保留 Anthropic 原生版本头（注意：本接口与 Chat Completions 不同，不使用 Bearer Token）：

HTTP Header

x-api-key: ${API_KEY}
anthropic-version: 2023-06-01
Content-Type: application/json

普通对话

cURL · 请求

curl --location --request POST 'https://hub.ai-leapx.com/v1/messages' \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: ${API_KEY}' \
  --header 'anthropic-version: 2023-06-01' \
  --data-raw '{
    "max_tokens": 256,
    "messages": [
      {
        "content": [{"type": "text", "text": "你好"}],
        "role": "user"
      }
    ],
    "model": "claude-haiku-4-5-20251001"
  }'

JSON · 响应

{
  "id": "msg_bdrk_01SW8FrxLH2ZgFMpgvSvkUsk",
  "type": "message",
  "role": "assistant",
  "model": "claude-haiku-4-5-20251001",
  "content": [
    {"type": "text", "text": "你好！很高兴认识你。有什么我可以帮助你的吗？"}
  ],
  "usage": {
    "input_tokens": 10,
    "output_tokens": 29,
    "cache_creation_input_tokens": 0,
    "cache_read_input_tokens": 0
  },
  "stop_reason": "end_turn",
  "stop_sequence": null
}

图片分析

cURL

curl --location --request POST 'https://hub.ai-leapx.com/v1/messages' \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: ${API_KEY}' \
  --header 'anthropic-version: 2023-06-01' \
  --data-raw '{
    "max_tokens": 256,
    "messages": [
      {
        "content": [
          {"text": "图片描述的是什么", "type": "text"},
          {
            "source": {
              "data": "/9j/4gIcSUNDX1BSTN+M/V0l7qkPTek...",
              "media_type": "image/jpeg",
              "type": "base64"
            },
            "type": "image"
          }
        ],
        "role": "user"
      }
    ],
    "model": "claude-haiku-4-5-20251001"
  }'

流式响应

cURL

curl --location --request POST 'https://hub.ai-leapx.com/v1/messages' \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: ${API_KEY}' \
  --header 'anthropic-version: 2023-06-01' \
  --data-raw '{
    "stream": true,
    "max_tokens": 256,
    "messages": [{"content": [{"type": "text", "text": "你好"}], "role": "user"}],
    "model": "claude-haiku-4-5-20251001"
  }'

SSE 事件序列：message_start → content_block_start → content_block_delta（多次）→ content_block_stop → message_delta → message_stop。

函数调用

cURL · 第一轮（模型决定调用工具）

curl --location --request POST 'https://hub.ai-leapx.com/v1/messages' \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: ${API_KEY}' \
  --header 'anthropic-version: 2023-06-01' \
  --data-raw '{
    "max_tokens": 256,
    "messages": [{"content": "今天合肥的天气怎么样", "role": "user"}],
    "model": "claude-haiku-4-5-20251001",
    "tools": [
      {
        "input_schema": {
          "type": "object",
          "properties": {
            "city": {"description": "the city name", "type": "string", "enum": []}
          }
        },
        "name": "get_the_weather_info",
        "description": "get the weather info"
      }
    ]
  }'

响应中 stop_reason 为 "tool_use"，content 数组包含 type: "tool_use" 内容块。客户端执行工具后，将结果以 tool_result 形式回传以完成第二轮。

请求体参数

参数	类型	必填	说明
model	String	必填	要使用的模型名称，1–256 字符。
messages	Array	必填	输入消息列表（user / assistant 角色交替）。连续同角色消息会被合并。
max_tokens	Integer	必填	生成的最大 token 数量，> 1。不同模型上限不同。
system	String	可选	系统 prompt。Messages API 中没有 system role，系统提示通过顶层 system 字段提供。
temperature	Number	可选	0.0 – 1.0，默认 1.0。分析任务建议接近 0，创造任务建议接近 1。
top_p	Number	可选	0 < x < 1。Nucleus 采样。建议只调整 temperature 或 top_p 其中之一。
top_k	Integer	可选	> 0。从 token 前 K 个选项中采样。建议仅在高级场景使用。
stream	Boolean	可选	是否使用 SSE 增量返回。
stop_sequences	Array	可选	自定义停止序列。
metadata	Object	可选	请求元数据，含 user_id（不透明标识符，不要包含 PII，最大长度 256）。
thinking	Object	可选	扩展思考模式。`{"type":"enabled","budget_tokens":2048}` 启用；`{"type":"disabled"}` 关闭。budget_tokens ≥ 1024 且小于 max_tokens。
tool_choice	Object	可选	工具选择策略：`auto`/`any`/`tool`，可指定 `disable_parallel_tool_use`。
tools	Array	可选	工具定义列表，支持自定义工具 + 内置 Computer / Bash / TextEditor 工具。

内容块类型

消息 content 可以是字符串，也可以是内容块数组。支持的内容块类型：

类型	关键字段	说明
`text`	text（最小长度 1）, cache_control	文本内容
`image`	source.type=base64, source.media_type, source.data	图片，支持 image/jpeg、png、gif、webp
`tool_use`	id, name, input	模型生成的工具调用
`tool_result`	tool_use_id, content, is_error	客户端回传的工具执行结果
`document`	source	文档输入

响应体参数

字段	类型	说明
id	String	响应唯一标识符
type	String	始终为 `"message"`
role	String	始终为 `"assistant"`
model	String	使用的模型名称
content	Array	由内容块（text / tool_use）组成的输出列表
stop_reason	String / null	`end_turn` / `max_tokens` / `stop_sequence` / `tool_use`
stop_sequence	String / null	命中的自定义停止序列（如有）
usage	Object	input_tokens / output_tokens / cache_creation_input_tokens / cache_read_input_tokens

✨Gemini 原生

POST https://hub.ai-leapx.com/v1beta/models/{model}:generateContent

此端点保持 Google Gemini REST 原生请求与响应结构，支持文本生成、多模态理解、函数调用和 Gemini 图片生成。{model} 必须替换为模型广场或 GET /v1/models 返回的公开模型 ID。

项目	说明
Base URL	`https://hub.ai-leapx.com`（原生路径已包含 `/v1beta`，不要再拼接 `/v1`）
API 版本	`v1beta`
认证	推荐请求头 `x-goog-api-key: ${API_KEY}`；也兼容 URL 参数 `?key=${API_KEY}`，二选一即可
Content-Type	`application/json`

请求体（Request Body）

JSON · 结构

{
  "contents": [],
  "systemInstruction": {},
  "generationConfig": {},
  "safetySettings": [],
  "tools": [],
  "toolConfig": {},
  "cachedContent": ""
}

参数	类型	必填	说明
contents	array<Content>	必填	对话内容列表
systemInstruction	Content	可选	系统指令
generationConfig	GenerationConfig	可选	生成参数配置
safetySettings	array<SafetySetting>	可选	安全过滤设置
tools	array<Tool>	可选	工具/函数声明
toolConfig	ToolConfig	可选	工具调用行为配置
cachedContent	string	可选	缓存内容资源名称

Content / Part 对象

Content 表示一条对话消息：role（user / model）和 parts（消息内容部分列表）。每个 Part 互斥地包含以下之一：

字段	类型	说明
text	string	文本内容
inlineData	Blob	内联二进制数据（图片/音频/视频等）。Blob: { mimeType, data (Base64) }
fileData	FileData	通过 URI 引用的文件数据。FileData: { mimeType, fileUri }
functionCall	FunctionCall	模型返回的函数调用（仅 model 角色）。{ name, args }
functionResponse	FunctionResponse	用户回传的函数执行结果（仅 user 角色）。{ name, response }

GenerationConfig 对象

字段	类型	默认值	说明
temperature	number	模型默认	控制随机性，0.0–2.0
topP	number	模型默认	核采样概率阈值，0.0–1.0
topK	integer	模型默认	Top-K 采样
candidateCount	integer	1	返回候选数量
maxOutputTokens	integer	模型默认	最大输出 token 数
stopSequences	array<string>	无	停止序列（最多 5 个）
presencePenalty	number	0.0	存在惩罚
frequencyPenalty	number	0.0	频率惩罚
responseMimeType	string	text/plain	响应格式：text/plain / application/json
responseSchema	Schema	无	结构化输出的 JSON Schema 定义
seed	integer	无	随机种子
responseLogprobs	boolean	false	是否返回 token 对数概率
logprobs	integer	无	返回的 top log probabilities 数量
thinkingConfig	ThinkingConfig	无	思考模式配置（Gemini 2.5+ 支持）。`thinkingBudget` 0–24576；`thinkingLevel`（仅 Gemini 3 支持，与 thinkingBudget 互斥）。
audioTimestamp	boolean	false	是否启用音频时间戳
mediaResolution	string	无	媒体分辨率控制

SafetySetting 对象

每个 HarmCategory 最多设置一个：{ category, threshold }。

HarmCategory：HARM_CATEGORY_HARASSMENT / HATE_SPEECH / SEXUALLY_EXPLICIT / DANGEROUS_CONTENT / CIVIC_INTEGRITY
HarmBlockThreshold：HARM_BLOCK_THRESHOLD_UNSPECIFIED / BLOCK_LOW_AND_ABOVE / BLOCK_MEDIUM_AND_ABOVE / BLOCK_ONLY_HIGH / BLOCK_NONE / OFF（Gemini 2.5+ 默认）

Tool / ToolConfig

工具通过 functionDeclarations 列表声明，每项含 name / description / parameters（OpenAPI Schema 子集，type 取值 STRING / NUMBER / INTEGER / BOOLEAN / ARRAY / OBJECT）。

toolConfig.functionCallingConfig.mode：AUTO（默认）/ ANY（强制调用）/ NONE（禁止调用）。ANY 模式可通过 allowedFunctionNames 限制范围。

基础文本对话

cURL

curl -X POST \
  "https://hub.ai-leapx.com/v1beta/models/gemini-2.5-flash:generateContent" \
  -H "x-goog-api-key: ${API_KEY}" \
  -H "Content-Type: application/json" \
  -d '{
    "contents": [
      {"role": "user", "parts": [{"text": "你好，请介绍一下你自己"}]}
    ]
  }'

带系统指令和生成配置

cURL

curl -X POST \
  "https://hub.ai-leapx.com/v1beta/models/gemini-2.5-flash:generateContent" \
  -H "x-goog-api-key: ${API_KEY}" \
  -H "Content-Type: application/json" \
  -d '{
    "systemInstruction": {
      "parts": [{"text": "你是一个智能助手，回答简洁友好。"}]
    },
    "contents": [
      {"role": "user", "parts": [{"text": "今天天气怎么样？"}]}
    ],
    "generationConfig": {
      "temperature": 0.7,
      "topP": 0.95,
      "topK": 40,
      "maxOutputTokens": 1024
    },
    "safetySettings": [
      {"category": "HARM_CATEGORY_HARASSMENT", "threshold": "BLOCK_MEDIUM_AND_ABOVE"},
      {"category": "HARM_CATEGORY_DANGEROUS_CONTENT", "threshold": "BLOCK_MEDIUM_AND_ABOVE"}
    ]
  }'

多模态（图片理解）

cURL · inlineData

curl -X POST \
  "https://hub.ai-leapx.com/v1beta/models/gemini-2.5-flash:generateContent" \
  -H "x-goog-api-key: ${API_KEY}" \
  -H "Content-Type: application/json" \
  -d '{
    "contents": [{
      "role": "user",
      "parts": [
        {"text": "描述这张图片的内容"},
        {"inlineData": {"mimeType": "image/jpeg", "data": "BASE64_ENCODED_IMAGE_DATA"}}
      ]
    }]
  }'

大文件提示：大文件建议使用 GCS 存储桶（fileData.fileUri 引用 gs://...），存储桶必须设置为公开可读，否则返回 403 PERMISSION_DENIED。fileData 文件上限 2GB（gemini-2.0-flash 及以上）。

函数调用

cURL

curl -X POST \
  "https://hub.ai-leapx.com/v1beta/models/gemini-2.5-flash:generateContent" \
  -H "x-goog-api-key: ${API_KEY}" \
  -H "Content-Type: application/json" \
  -d '{
    "contents": [{"role": "user", "parts": [{"text": "帮我打开微信"}]}],
    "tools": [{
      "functionDeclarations": [{
        "name": "launchApp",
        "description": "启动指定的桌面应用程序",
        "parameters": {
          "type": "OBJECT",
          "properties": {"appName": {"type": "STRING", "description": "应用程序名称"}},
          "required": ["appName"]
        }
      }]
    }],
    "toolConfig": {"functionCallingConfig": {"mode": "AUTO"}}
  }'

响应体（Response Body）

JSON

{
  "candidates": [
    {
      "content": {
        "role": "model",
        "parts": [{"text": "模型回复内容"}]
      },
      "finishReason": "STOP",
      "index": 0,
      "safetyRatings": [
        {"category": "HARM_CATEGORY_HARASSMENT", "probability": "NEGLIGIBLE"}
      ]
    }
  ],
  "usageMetadata": {
    "promptTokenCount": 10,
    "candidatesTokenCount": 50,
    "totalTokenCount": 60
  },
  "modelVersion": "gemini-2.5-flash"
}

FinishReason 枚举：STOP / MAX_TOKENS / SAFETY / RECITATION / LANGUAGE / BLOCKLIST / PROHIBITED_CONTENT / FINISH_REASON_UNSPECIFIED。

HarmProbability 枚举：NEGLIGIBLE / LOW / MEDIUM / HIGH。

流式生成（streamGenerateContent）

POST https://hub.ai-leapx.com/v1beta/models/{model}:streamGenerateContent?alt=sse

请求体与 generateContent 完全相同。响应以 text/event-stream 格式返回，每个 data: 行是一个 JSON 片段：

SSE

data: {"candidates":[{"content":{"role":"model","parts":[{"text":"你"}]},"index":0}]}

data: {"candidates":[{"content":{"role":"model","parts":[{"text":"好"}]},"index":0}]}

data: {"candidates":[{"content":{"role":"model","parts":[{"text":"！"}]},"finishReason":"STOP","index":0}],"usageMetadata":{"promptTokenCount":10,"candidatesTokenCount":3,"totalTokenCount":13}}

🖼️图片生成 · OpenAI 兼容

POST https://hub.ai-leapx.com/v1/images/generations

POST https://hub.ai-leapx.com/v1/images/edits

兼容 OpenAI 图片协议，提供图片生成（generations）和图片编辑（edits）两类能力。模型广场中当前在售的图片模型均可使用图片生成统一入口，包括 GPT Image、Grok Imagine、Flux 和 Nano Banana 系列。

统一调用规则：请把描述文字放在请求体顶层的非空 prompt 字段中。不要把 Gemini 的 contents 或视频接口的 input / parameters 结构提交到这个端点。

模型 ID：必须直接使用模型广场或 GET /v1/models 返回的公开 ID，例如 gpt-image-1、gpt-image-1.5、gpt-image-2、open.gpt-image-2、grok-imagine-image-2.0。请勿添加供应商内部前缀或后缀。

注意：模型生成的图片具有时效性，一般有效时长为 1 小时，请及时保存到您自己的存储系统中。

图片生成 — 请求参数

参数	说明	必填	类型
model	模型名称	必填	String
prompt	图片描述提示词	必填	String
n	生成图片数量，1–10，默认 1	可选	Integer
size	图片尺寸（按模型不同有不同限制，详见下文）	可选	String
quality	图像质量，常用取值 `low` / `medium` / `high` / `auto`；实际可用值以所选模型为准	可选	String
response_format	`url`（默认）/ `b64_json`	可选	String
style	DALL-E 3 风格：`natural` / `vivid`（默认）	可选	String
其他参数	模型特有参数，支持透传（如 seed、guidance_scale 等）	可选	Any

size 取值参考：

DALL-E 3：1024x1024 / 1792x1024 / 1024x1792
gpt-image-1：1024x1024 / 1024x1536 / 1536x1024
GPT-image-2 热门尺寸：1024x1024（方形）/ 1536x1024（横向）/ 1024x1536（竖屏）/ 2048x2048（2K 方形）/ 2048x1152（2K 横屏）/ 3840x2160（4K 横屏）/ 2160x3840（4K 竖屏）/ auto（默认）
尺寸约束：最大边长 ≤ 3840px；两边均为 16px 倍数；长短边比率不超过 3:1；总像素 655,360–8,294,400

示例代码

cURL · 图片生成

curl -X POST https://hub.ai-leapx.com/v1/images/generations \
  -H "Authorization: Bearer leapx_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2",
    "prompt": "一条可爱的小狗在草地上奔跑",
    "n": 1,
    "size": "1024x1024",
    "quality": "medium",
    "response_format": "url"
  }'

返回参数

字段	说明	类型
created	Unix 时间戳（秒）	Long
data	生成的图片列表	List
data.revised_prompt	模型修改后的提示词	String
data.url	图片 URL（response_format=`url`）	String
data.b64_json	图片 Base64（response_format=`b64_json`）	String
usage.input_tokens	输入 Token 总数（含 text_tokens / image_tokens 明细）	Integer
usage.output_tokens	输出 Token 总数（含 text_tokens / image_tokens 明细）	Integer
usage.total_tokens	Token 总计	Integer

图片编辑（edits）

支持两种请求格式：JSON 和 multipart/form-data（兼容 OpenAI 原厂 SDK 的文件上传）。

方式一：JSON 请求

image（必填，Array）：图片 URL 列表，或 Base64 列表（格式 data:image/<格式>;base64,<数据>）。每张 < 25MB，支持 PNG / WEBP / JPG。
mask（可选）：遮罩图片（URL 或 Base64），用于指定需要编辑的区域。
prompt（必填）：编辑指令提示词。

cURL · 图片编辑（JSON）

curl -X POST https://hub.ai-leapx.com/v1/images/edits \
  -H "Authorization: Bearer API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-1",
    "prompt": "在天空中添加一道彩虹",
    "image": ["https://example.com/original-image.png"],
    "n": 1,
    "size": "1024x1024",
    "response_format": "url"
  }'

方式二：multipart/form-data

cURL · 文件上传

curl -X POST https://hub.ai-leapx.com/v1/images/edits \
  -H "Authorization: Bearer API_KEY" \
  -F "model=gpt-image-1" \
  -F "prompt=给人物添加一顶帽子" \
  -F "image[]=@/path/to/image1.png" \
  -F "image[]=@/path/to/image2.png" \
  -F "mask=@/path/to/mask.png" \
  -F "n=1" \
  -F "size=1024x1024"

额外参数透传

除标准字段外，接口支持透传模型特有的额外参数（如 seed、guidance_scale），在 JSON 请求体中直接添加即可。

🎨图片生成 · Gemini 原生

POST https://hub.ai-leapx.com/v1beta/models/{model}:generateContent

此接口保持 Google Gemini 原生请求与响应结构，支持模型广场中的 Gemini 图片模型（如 nano-banana-pro-preview）。URL 中的模型 ID 必须使用模型广场或 /v1/models 返回的公开 ID，不能使用上游内部名称（例如带 -e 的内部后缀）。imageConfig 控制分辨率：1K / 2K / 4K，aspectRatio 控制宽高比。

文生图

cURL

curl --location --request POST \
  'https://hub.ai-leapx.com/v1beta/models/nano-banana-pro-preview:generateContent' \
  --header 'Content-Type: application/json' \
  --header 'x-goog-api-key: leapx_api_key' \
  --data-raw '{
    "contents": [
      {"role": "user", "parts": [{"text": "一条狗"}]}
    ],
    "generationConfig": {
      "responseModalities": ["TEXT", "IMAGE"],
      "imageConfig": {"aspectRatio": "16:9", "imageSize": "2K"}
    }
  }'

参考图生图

cURL

curl --location --request POST \
  'https://hub.ai-leapx.com/v1beta/models/nano-banana-pro-preview:generateContent' \
  --header 'Content-Type: application/json' \
  --header 'x-goog-api-key: leapx_api_key' \
  --data-raw '{
    "contents": [{
      "role": "user",
      "parts": [
        {"text": "画条狗"},
        {"fileData": {"mimeType": "image/jpg", "fileUri": "https://cdn.pixabay.com/photo/.../tree-736885_1280.jpg"}}
      ]
    }],
    "generationConfig": {
      "responseModalities": ["TEXT", "IMAGE"],
      "imageConfig": {"aspectRatio": "16:9", "imageSize": "2K"}
    }
  }'

从返回结果的 candidates[].content.parts[] 中取出图片的 Base64 数据：

JSON · 响应结构

{
  "candidates": [{
    "content": {"role": "...", "parts": [{}]},
    "finishReason": "...",
    "safetyRatings": [{}]
  }],
  "usageMetadata": {
    "promptTokenCount": 0,
    "candidatesTokenCount": 0,
    "totalTokenCount": 0
  }
}

🔊语音合成（TTS）

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

语音合成（Text-to-Speech）将文本转换为自然语音，基于学习大量语音样本掌握韵律、语调和发音规则，生成接近真人的语音。

应用场景

智能客服：多行业多场景语音合成，定制个性化人声
智能设备：智能家居、音箱、车载、可穿戴设备配音
有声阅读：故事、小说、新闻朗读
新闻播报：多种发音风格的新闻播报
无障碍播报：面向各类人群的文字转语音
内容创作：自媒体、视频配音
在线教育：复刻在线课堂老师的声音

入参参数

参数	说明	必填	类型
model	模型 ID	必填	String
input	合成参数对象	必填	JSON
input.text	合成文本	必填	String
input.voice	合成语音音色（在控制台「开通管理 → 语音合成 → 我的音色」获取）	必填	String

示例代码

替换说明：示例中的 <YOUR_MODEL_ID> 与 <YOUR_VOICE_ID> 必须替换为您账号下实际开通的模型 ID 与音色 ID。模型 ID 通过 GET /v1/models（filter type=speech_model）获取；音色 ID 在控制台「开通管理 → 语音合成 → 我的音色」获取。

cURL

curl -X POST https://hub.ai-leapx.com/v1/audio/speech \
  -H "Authorization: Bearer API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "<YOUR_MODEL_ID>",
    "input": {
      "text": "那我来给大家推荐一款T恤，这款呢真的是超级好看。推荐宝宝们下单哦。",
      "voice": "<YOUR_VOICE_ID>"
    }
  }'

返回示例

JSON

{
  "code": 200,
  "msg": "语音合成成功",
  "data": {
    "url": "https://hub.ai-leapx.com/63d8ba50b8da4f3d9d41131b99583fb3.mp3"
  }
}

🎬视频生成：Seedance / MiniMax H3

POSThttps://hub.ai-leapx.com/v1/videos

GEThttps://hub.ai-leapx.com/v1/videos/{video_id}

GEThttps://hub.ai-leapx.com/v1/videos/{video_id}/content

使用 LeapX 统一视频接口调用 Seedance 2.0、Seedance 2.5 与 MiniMax H3。接口采用「创建任务 → 查询状态 → 下载结果」的异步流程，适用于文生视频与首帧图生视频。

只传 LeapX 公开扁平格式：model、prompt、seconds、size 与首帧图片字段均放在 JSON 顶层。不要传递上游的嵌套 input / parameters 结构。

⚠️ 先确认模型 ID：调用 GET /v1/models 或在模型广场查看已开通的公开模型 ID。模型能力、可选时长与尺寸因账号已开通的型号而异；请勿使用供应商内部 ID。

已提供的视频模型

模型系列	公开模型 ID（示例）	支持分辨率	适用场景	规格提示
Seedance 2.0	`doubao-seedance-2.0`	`480p`、`720p`、`1080p`、`4K`	文生视频、首帧图生视频；开通参考能力时可传参考视频。	用 `seconds`、`size` 选择已开通的时长与尺寸。
Seedance 2.5	`doubao-seedance-2.5-token`	`480p`、`720p`、`1080p`	文生、图生与参考素材驱动的视频生成；更复杂的原生多模态编辑能力以账号开通与平台公开字段为准。	选择模型当前已配置的时长与尺寸；不要将原生嵌套请求体直接提交到 LeapX。
MiniMax H3	`MiniMax-H3`	`768P`、`2K`	使用同一视频接口创建异步任务。首帧和参考素材是否可用，以该模型在账号下的开通能力为准。	不支持 `720P` / `1080P`。本示例使用 `768P`；使用 `2K` 前请确认该档位已开通且可计费。

模型 ID 以账号返回为准：上表仅作快速选型。若 GET /v1/models 未返回某个 ID，请先在模型广场开通，不要自行拼接或替换版本后缀。

能力与输入方式

生成方式	需要的字段	说明
文生视频	`model`、`prompt`	用文字描述主体、动作、镜头、场景与风格。
首帧图生视频	`model`、`prompt`、`first_frame_url`	以一张可公开访问的首帧图片作为起始画面。

首帧图片必须是服务端可读取的公开 URL。

创建任务参数

字段	类型	必填	说明
`model`	String	是	模型广场或 `GET /v1/models` 返回的公开 ID。
`prompt`	String	是	视频提示词，支持中文和英文。建议明确主体、动作、场景、镜头与风格。
`seconds`	Integer	建议	生成时长（秒）。请使用模型已开通的时长档位；未填或为 `0` 时，系统尝试使用模型默认档位。
`size`	String	建议	生成尺寸或分辨率标识，例如 `1280x720` 或 `768P`。支持项请以模型表为准：Seedance 2.0 为 `480p` / `720p` / `1080p` / `4K`，Seedance 2.5 为 `480p` / `720p` / `1080p`，MiniMax H3 为 `768P` / `2K`。仅传入已开通且可计费的档位。
`first_frame_url`	String	否	首帧图片的公开 URL，用于图生视频。
`duration`	Integer	否	`seconds` 的兼容别名；新接入请优先使用 `seconds`。

生成流程

创建任务：调用 POST /v1/videos，保存响应中的 id 与 content_url。
轮询状态：调用 GET /v1/videos/{video_id}，建议每 10–20 秒一次并采用指数退避。状态为 queued、in_progress、completed 或 failed。
保存结果：仅在 completed 后请求 content_url 或 GET /v1/videos/{video_id}/content，并立即转存到自有存储。生成结果的来源链接可能过期。

文生视频：Seedance 2.0 范例

在接口调试工具中，将以下三部分分别填入 URL、Headers 与 Body → JSON。URL 与 Headers 适用于 Seedance 2.0、Seedance 2.5 和 MiniMax H3；每一项都可以单独复制。

1. URL（POST）

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

2. Headers

Authorization: Bearer leapx_api_key
Content-Type: application/json

3. JSON Body

{
  "model": "doubao-seedance-2.0",
  "prompt": "一只熊猫在竹林中缓慢行走，电影感镜头",
  "seconds": 5,
  "size": "1280x720"
}

将示例中的 leapx_api_key 替换为你在 LeapX 创建的实际 API Key。

Seedance 2.5 示例

端点、鉴权与轮询流程完全相同。以下请求体可直接复制到接口工具的 Body → JSON 中，示例分辨率为 1280x720；如需调整，请使用该模型已开通且已定价的实际值。

JSON · Seedance 2.5

{
  "model": "doubao-seedance-2.5-token",
  "prompt": "雨中的港口，镜头缓慢推向停泊的船只",
  "seconds": 5,
  "size": "1280x720"
}

MiniMax H3 示例

URL 与 Headers 使用上方的独立复制项。以下请求体使用 768P，可直接复制到 Body → JSON 中。

JSON · MiniMax H3

{
  "model": "MiniMax-H3",
  "prompt": "一只金毛在草地上奔跑，阳光逆光，跟拍镜头",
  "seconds": 5,
  "size": "768P"
}

MiniMax H3 分辨率：支持 768P 与 2K，不使用 720P 或 1080P。本示例固定使用 768P；如需 2K，请先确认该档位已开通且可计费。若返回 size_not_priced，请联系支持开通对应分辨率的计费档位。

JSON · 创建响应

{
  "id": "video_68d7512d07848190b678d5",
  "object": "video",
  "created_at": 1758941485,
  "status": "queued",
  "model": "doubao-seedance-2.0",
  "content_url": "https://hub.ai-leapx.com/v1/videos/video_68d7512d07848190b678d5/content"
}

API 测试工具中成功创建视频任务的请求与响应示例 — 任务创建成功示例：返回 `status: queued` 表示任务已进入队列。请保存响应中的 `id`，再查询任务状态；视频完成后再下载 `content_url`。

首帧图生视频

模型支持时，在顶层传入 first_frame_url。图片 URL 需由服务端直接读取，分辨率、格式与尺寸限制以所选模型为准。

cURL · JSON

curl -X POST "https://hub.ai-leapx.com/v1/videos" \
  -H "Authorization: Bearer leapx_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "doubao-seedance-2.0",
    "prompt": "她转身微笑，然后缓慢走出画面",
    "seconds": 5,
    "size": "1280x720",
    "first_frame_url": "<PUBLIC_IMAGE_URL>"
  }'

状态与错误处理

HTTP 状态	error.code	处理建议
400	`invalid_request`、`model_missing`、`prompt_missing`	检查 JSON、模型 ID 与提示词。
400	`size_not_priced`、`price_not_configured`	将时长与尺寸改为该模型已开通、已定价的档位。
402	`insufficient_quota`	充值或更换仍有可用额度的 API Key。
403	`model_blocked_by_policy`、`forbidden`	开通模型，或使用创建任务时的同一 API Key 查询。
404	`task_not_found`	检查视频任务 ID。
502	`upstream_failed`、`upstream_rejected`	稍后重试；若任务最终为 `failed`，请调整素材或提示词后重新创建任务。

安全提示：content_url 可直接在浏览器打开，请将任务 ID 和结果链接视为敏感内容；不要在公开页面、日志或前端代码中暴露 API Key。

📦模型列表

GET https://hub.ai-leapx.com/v1/models

列出当前账号可用的全部模型，包含每个模型的基本信息。

请求示例

cURL

curl --location --request GET 'https://hub.ai-leapx.com/v1/models' \
  --header 'Content-Type: application/json' \
  --header "Authorization: Bearer API_KEY"

响应示例

JSON

{
  "object": "list",
  "data": [
    {
      "id": "model-id-0",
      "object": "model",
      "created": 1686935002,
      "owned_by": "LeapX",
      "type": "text_model"
    }
  ]
}

返回参数

字段	说明	类型
id	模型标识符，可在 API 端点中引用	String
object	对象类型，固定为 `"model"`	String
created	Unix 时间戳（秒）	Integer
owned_by	模型所属组织	String
type	模型类型，见下表	String

type 取值：

text_model — 文本模型
image_generation — 图像生成模型
visual_model — 视频模型
speech_model — 语音合成模型
transcription_model — 语音识别模型

🔑AccessKey 管理

AccessKey 是请求平台 OpenAPI（如账单接口）的凭证，与普通 API Key 不同。每个身份最多创建 5 对密钥。

实践建议

定期轮换：创建第二对密钥替换第一对，轮换完成后禁用第一对。
清理闲置：对长期不使用的密钥进行禁用或删除。
避免泄露：勿将 AccessKey 写入代码或存储在代码仓库中，避免将密钥分享到公开环境（如 GitHub）。

创建入口

登录平台后，访问控制台「AccessKey 管理」页面获取 Access Key ID 与 Secret Access Key。

💳获取账单接口

GET https://hub.ai-leapx.com/openApi/queryModelBill

按时间区间查询账户用量账单。在 AccessKey 管理页面获取 Access Key ID 与 Secret Access Key，使用 AccessKey 签名鉴权。

请求示例

cURL

curl -X GET "https://hub.ai-leapx.com/openApi/queryModelBill?startDate=20251118&endDate=20260225" \
  --header 'X-Date: 20260227T035311Z' \
  --header 'X-Access-Key-Id: kjvXZNzdlDIoC******wBd9306S9d6KlcIKFOc1Jz4' \
  --header 'X-Signature: 0075105a5aa5bcccb37b0c73c211*******4a4589bd7a90c0b5d'

请求参数

参数	说明	必填	类型
startDate	账单查询开始时间，格式 `YYYYMMDD`	必填	String
endDate	账单查询结束时间，格式 `YYYYMMDD`	必填	String
X-Date	UTC 时间，精确到秒，ISO 8601 格式：`YYYYMMDD'T'HHMMSS'Z'`	必填	String
X-Access-Key-Id	AccessKey 管理中获取的 Access Key ID	必填	String
X-Signature	方法签名（使用 Secret Access Key 对请求计算）	必填	String

注意：单次查询的开始时间与结束时间区间不得超过 100 天。签名算法支持 Java / Python / JavaScript 等多语言示例，请在控制台获取。

响应字段

顶层包含用户信息（nickName / accountId / accountType / phone / email）与账单列表 modelBills。每条账单含 billTime、orderNum、status（1 已结清 / 2 出账中 / 3 欠费）以及 useInfo 用量明细。

每条 useInfo 含 apiKeyId / apiKeyName / totalPrice，以及多模型用量列表 modelDetails：modelName、model、serviceProvider、rateCardRate（刊例价）、totalPrice、modelAttribute（模型属性同 type）、usage、usageUnit。

刊例价示例

文本模型：文本输入：14~28元/M tokens 文本输出：84~126元/M tokens（有缓存计费时在后追加；价格区间表示当天实时变动）
图片生成：0.2元/次 或 文本输入:35元/M tokens 图片输入:70.5元/M tokens 输出:280元/M tokens
视频生成：标清:0.4375元/1秒/次高清:0.9375元/1秒/次超清:1元/1秒/次
语音合成：3.5元/万字符

👥企业子账号管理

LeapX 支持企业子账号共用，满足团队协作、企业主号付款的需求。

子账号只能共享企业主号的余额，无财务管理权限，无法充值
子账号需要单独开通所需模型或购买量包

一、转为企业号

如您已经是企业号，可忽略此步骤。登录账号后点击「个人中心 → 账户管理 → 转为企业号」，填写信息即可。

二、子账号管理

账号创建：「个人中心 → 子账号管理」按要求填写子账号信息；使用子账号登录地址登录后绑定员工本人手机号。
用户组添加：在「用户组」可添加部门、团队、子公司等用户组。
角色管理：添加角色，目前只需对非默认菜单进行授权即可，模型广场等默认菜单已默认展示。

🤖Hermes Agent 接入

Hermes Agent 配置使用 LeapX。详细的图文配置步骤请联系 LeapX 客服或参考控制台「使用教程」页。

关键配置：Base URL https://hub.ai-leapx.com/v1，API Key 在控制台「API Key 管理」获取。

⌨️LeapX × Claude Code

使用 LeapX 平台为 Claude Code（Anthropic 官方 CLI）提供模型能力。详细的图文配置步骤请参考控制台「使用教程」中的「平台 X Claude Code」专题文档。

核心配置：将 Claude Code 的 ANTHROPIC_BASE_URL 指向 https://hub.ai-leapx.com/v1，ANTHROPIC_AUTH_TOKEN 设置为您的 LeapX API Key，即可使用 LeapX 提供的 Claude 系列模型。

🧩CC Switch 使用指南

推荐使用 CC Switch 的统一供应商模式接入 LeapX。这样可以在同一份供应商配置中同时管理 Claude、Codex 和 Gemini，修改后也更容易同步到已启用的客户端。

核心原则：接入文档中的所有 API 基础地址统一使用 hub.ai-leapx.com，避免混用旧域名。

步骤 1：添加统一供应商

在 CC Switch 中点击新增供应商，切换到右侧的 统一供应商 标签，然后添加一个指向 LeapX 的供应商。

选择「统一供应商」后新增 LeapX，后续配置会在这个供应商下完成。

步骤 2：编辑供应商配置

进入供应商详情后，将 API 模式设置为 Anthropic Messages (原生)，并根据 LeapX 控制台可用模型配置 Sonnet、Opus、Fable、Haiku 等映射。

示例中使用 Anthropic 原生协议，适合 Claude Code 一类以 Anthropic 协议接入的客户端。

步骤 3：补充配置 JSON

在配置 JSON 的 env 中加入以下两行，避免实验特性与非必要流量影响稳定性：

JSON

{
  "CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS": "1",
  "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1"
}

这两个环境变量直接与 Token、Base URL、默认模型配置并列即可。

步骤 4：确认连接状态

配置完成后返回主界面，如果供应商卡片显示 leapx 且连接正常，说明 CC Switch 已经能通过 LeapX 正常通信。

出现连接正常提示后，再继续去 Claude Code 等客户端做最终验证。

步骤 5：在 Claude Code 中验证

最后打开 Claude Code，确认它已经加载到对应配置文件，并发起一次简单对话测试。如果模型能正常回答，代表链路已打通。

看到 Claude Code 正常启动并能返回回答，就说明接入可用。

📝Cursor 中使用 Claude

前提条件

拥有一个 Cursor Pro 账号（免费版只能短期试用 API 配置功能）。
在 ai-leapx.com 获取 API Key，并确保已开通 Claude 系列的模型服务。

说明：由于 Cursor 对 Claude 模型路径做正则匹配，model 名称包含 "claude" 字样会自动走 Anthropic 路径。因此 LeapX 对 Claude 模型做了别名（例如 kld-o-4.6 对应 claude opus 4.6），方便在 Cursor 中调用。

Cursor 配置步骤

进入 Cursor 后台「Settings → Models」，滑动页面展开「API Keys」。
依次填写：
API Keys：LeapX 控制台获取的 API 密钥
Base URL：https://hub.ai-leapx.com/v1 （务必填写正确）
开启 API Keys 开关，添加新模型，点击 Verify 校验。校验时使用的模型必须是 LeapX 提供的可用模型。
在对话区选择 ASK 模式 + 配置的模型，即可开始使用。

🧩在 Cline 中使用

安装 Cline

在 VSCode 中搜索并安装 Cline 插件。

打开 Cline 配置

在 VSCode 中通过 Ctrl/Command + Shift + P 打开命令工具，在新 tab 中打开 Cline 进行配置。

配置项

项目	值
API Provider	选择 `OpenAI Compatible`
Base Url	`https://hub.ai-leapx.com/v1`
API Key	从 ai-leapx.com 控制台获取（参考快速开始）
Model ID	从 ai-leapx.com 控制台「开通管理」获取

点击 Let's Go 即可使用。

⚡在 Dify 使用海外高速 GPT

使用前可先在 ai-leapx.com 注册账号，新用户可领 15 元代金券。

🎯 痛点解决：✅ 无需翻墙（告别 VPN 限制） ✅ 免国际信用卡（支付宝/微信直接支付） ✅ 即时调用全球优质模型

配置步骤

打开 Dify「Settings」。
选择导航栏「Model Provider」，添加兼容 OpenAI 接口的模型插件（如 GPUSTACK）。

在插件中填写：

Model Name	从 LeapX 控制台「开通管理」获取（OpenAI 插件只支持 GPT 系列）
API Key	LeapX 控制台获取
API 端点 URL	`https://hub.ai-leapx.com/v1`

设置完成后，可在模型列表中看到新增的模型。

📄WPS · OfficeAI 插件

一、安装 OfficeAI 助手插件

访问下载地址：office-ai.cn 下载页
根据自身习惯进行安装。

二、配置 WPS

打开文档后选择「文件 → 选项 → 信任中心」，勾选「启用所有第三方 COM 加载项」，点击确认。
确认后关闭 WPS 重启，出现 OfficeAI 工具项。

三、设置 LeapX 大模型 API

点击 OfficeAI → 设置 → 大模型 → 选择「ApiKey」项，按以下任一方式添加配置：

方式一

APIURL	`https://hub.ai-leapx.com/v1/chat/completions`
API Key & 模型 ID	从 ai-leapx.com 获取

添加模型后点击左侧选择即可出现。

方式二（兼容性更好）

点击「新增服务商」，配置同上。注意：不要点击"智能检查"——智能检查目前只对已集成到插件内的服务商有效。

配置完成后点击 OfficeAI 插件，根据下方出现的工具栏使用相关功能，支持文档、表格等。

🖼️在 Dify 中使用 LeapX 生成图片

🎯 痛点解决：✅ 无需翻墙 ✅ 免国际信用卡 ✅ 即时调用全球优质模型

第一步：创建工具

打开 Dify 工作室，点击「创建 → 工作流」，输入自定义工作流名称。
点击创建后，点击「设置 → 导入 DSL」，选择 LeapX 提供的图片生成工作流 DSL 文件导入。
发布工作流为工具。

第二步：在 AI 应用中使用

创建自己的 AI 应用时，在编排页面添加节点，选择「工具」，选择刚才发布的工作流工具；点击节点进行工具参数设置即可使用。

🌐接入纳米 AI

前提条件

需获取 LeapX API Key，并确保已开通对应模型服务。由于纳米 AI 的功能可能发生变化，模型的支持情况以实际效果为准。

配置步骤

搜索"纳米 AI"，下载 PC 客户端并安装运行。
点击「大模型」进入大模型使用页面。
点击「自定义模型」→「添加模型」。
按要求填写参数。API 地址使用以 / 结尾的根路径或完整路径：

根路径 https://hub.ai-leapx.com/

完整路径 https://hub.ai-leapx.com/v1/chat/completions
点击「检测」，检测通过后自动开启。
回到大模型对话页面，选择配置好的模型即可体验，可配合纳米 AI 联网搜索与知识库使用。

🍒接入 Cherry Studio

前提条件

已获取 LeapX API Key，并开通对应模型服务
使用 Cherry Studio 1.6.0 及以上版本

下载客户端

访问 cherry-ai.com/download，按客户端版本下载并安装。

客户端配置

打开客户端，点击「设置 → 模型服务」，选择 LeapX 服务商（如未内置，可选「OpenAI Compatible」自定义服务商）。
填写 API Key 与 Base URL https://hub.ai-leapx.com/v1。
点击「管理」，获取模型列表，添加可用模型。
点击「助手」按钮，选择配置的服务商和模型，即可进行对话。

🧭浏览器插件 — Sider

安装 Sider 插件：在 Sider 官方网站下载并添加到浏览器。
进入通用配置：选择「OpenAI API key」，打开「使用我自己的网址」、「使用自定义模型名称」。
获取 LeapX URL 与 Key：在 LeapX 控制台点击「API Key」获取 Key；点击「开通管理」获取 URL 与 Model ID。
配置 Sider：将 URL、Key 与模型 ID 填入即可使用。

Base URL https://hub.ai-leapx.com/v1

🔍浏览器插件 — Glarity

安装 Glarity 插件：在 Glarity 官方网站下载并添加到浏览器。
进入通用配置：选择「OpenAI API key」，打开「高级配置」。

填入 LeapX 配置：

API Key	LeapX 控制台获取
Base URL	`https://hub.ai-leapx.com/v1`
Model	LeapX 控制台「开通管理」获取的 Model ID

🧠思考参数说明

各家模型厂商的思考（推理）参数不同，请按照所用模型选择对应的参数配置。

CMI 技术问题补充：如果你接入 Claude 系列模型并需要开启 thinking / 思考模式，请按具体模型要求传参，不要在所有模型上强制套用同一套配置。

CMI 示例 1 · claude-fable-5

适用于需要 summarized thinking 展示的场景：

JSON

{
  "model": "claude-fable-5",
  "max_tokens": 14800,
  "stream": false,
  "thinking": {
    "type": "adaptive",
    "display": "summarized"
  },
  "output_config": {
    "effort": "max"
  },
  "messages": [
    {
      "role": "user",
      "content": "你是什么模型呢,你能做什么"
    }
  ]
}

CMI 示例 2 · Claude Haiku 4.5

如需显式开启 thinking，可使用：

JSON

"thinking": {
  "type": "enabled",
  "budget_tokens": 2048
}

OpenAI 系列

reasoning_effort String 默认：medium

仅适用于推理模型，约束推理工作量。减少推理工作可加快响应速度并减少 Token 消耗。

low medium high

Anthropic 系列（Claude）

thinking Object 默认：{"type":"disabled"}

配置 Claude 的扩展思考功能。启用时响应包含思考过程内容块。需要至少 1024 token 预算，并计入 max_tokens 限制，开启思考时 max_tokens ≥ 1024。type 为必填值，开启思考时 budget_tokens 为必填值。

JSON

// 开启思考
"thinking": {"type": "enabled", "budget_tokens": 1024}

// 关闭思考
"thinking": {"type": "disabled"}

字节豆包系列

thinking Object 默认：{"type":"enabled"}

type 为必填字段。

enabled — 强制思考 disabled — 关闭思考 auto — 自动判断

千问 / DeepSeek 系列

enable_thinking Boolean

开启后思考内容通过 reasoning_content 字段返回。

true — 开启 false — 关闭

谷歌 Gemini 系列

thinking_config Object

对于 Pro 版本，思考功能无法关闭。thinking_level 与 thinking_budget 不能同时存在（同时存在返回 400）。

JSON

// 开启思考
"thinking_config": {"include_thoughts": true, "thinking_budget": 1024}

// 关闭思考
"thinking_config": {"include_thoughts": false, "thinking_budget": 0}

// Gemini 3 新参数（简化级别，仅 Gemini 3 支持）
"thinking_config": {"thinking_level": "low"}

thinking_budget 取值范围（Gemini 2.5）：

型号	最低 Token	最高 Token
Gemini 2.5 Flash	1	24,576
Gemini 2.5 Pro	128	32,768
Gemini 2.5 Flash-Lite	512	24,576

参考：Google 官方文档

💬Messages 参数说明（Chat Completions）

本章节描述 /v1/chat/completions 接口中 messages 数组的字段结构。每条消息属于一个角色（Role），消息列表按对话顺序排列。

system 系统消息（System Message）

用于告知模型角色或行为。默认值为 "You are a helpful assistant"。也可以将此类指令放在 user message 中，但放在 system message 中会更有效。

content必填 String — 系统消息内容
role必填 String — 固定为 "system"
name可选 String — 对话参与者名称

user 用户消息（User Message）

用户输入给模型的内容。content 支持纯文本或多模态数组（多模态数组仅多模态模型支持）。

role必填 String — 固定为 "user"
content必填 String | Array — 文本或多模态内容数组
name可选 String — 对话参与者名称

多模态内容类型

类型	关键字段	说明	支持模型
`text`	type, text	文本内容	所有模型
`image_url`	type, image_url.url, image_url.detail	图片 URL 或 Base64	多模态模型
`video_url`	type, video_url.url, videoMetadata / fps	视频内容。doubao 系列最大 50M；Gemini HTTP 网址最大 15MB；GCS 存储桶 URI 最大 2GB（gemini-2.0-flash 及以上）	Gemini、豆包
`file`	type, file.file_data, file.filename, file.file_type	文件 Base64。亚马逊厂商模型必传 file_type，支持 pdf / csv / doc / docx / xls / xlsx / html / txt / md	亚马逊、谷歌云
`input_audio`	type, input_audio.data, input_audio.format	音频 Base64 或谷歌存储桶数据，例 `audio/mp3`	Gemini

assistant 助手消息（Assistant Message）

模型的回复；也可预填充作为后续回复的示例。

content必填* String — 助手消息内容（指定 tool_calls 时除外）
role必填 String — 固定为 "assistant"
name可选 String — 对话参与者名称
tool_calls可选 Array — 模型生成的工具调用列表，每项含 id / type（仅支持 "function"）/ function（name + arguments）

📐返回格式化

OpenAI 系列 — response_format

对象类型，非必填，指定模型必须输出的格式。

设置值	效果
`{"type": "json_schema", "json_schema": {...}}`	结构化输出，模型输出匹配指定 JSON Schema
`{"type": "json_object"}`	JSON 模式，输出为合法 JSON

注意：使用 JSON 模式时，您必须通过 system 或 user 消息自行指示模型生成 JSON，否则模型可能会生成无尽的空白直到达到 token 限制。

谷歌 Gemini 系列

参数	说明
response_mime_type	`text/plain`（默认）/ `application/json` / `text/x.enum`
response_schema	非必填，指定输出结构。需配合非 `text/plain` 的 MIME 类型使用

Schema 对象属性：

属性	类型	必需	说明
type	枚举	必填	数据类型
description	字符串	可选	字段描述
enum	数组	可选	枚举值列表（type 为 string 时）
example	任意	可选	示例值
nullable	布尔	可选	是否可为 null
format	字符串	可选	字符串格式（如 date、date-time）
items	对象	可选	数组项 Schema（type 为 array 时）
properties	对象	可选	对象属性 Schema（type 为 object 时）
required	数组	可选	必需属性名称列表
minimum / maximum	数字	可选	数字范围
minItems / maxItems	整数	可选	数组长度范围
minLength / maxLength	整数	可选	字符串长度范围

⚠️错误码

通用错误格式（OpenAI / 图片接口）

JSON

{
  "error": {
    "message": "错误描述信息",
    "type": "错误类型",
    "code": null
  }
}

Gemini 错误格式

JSON

{
  "error": {
    "code": 400,
    "message": "错误描述信息",
    "status": "INVALID_ARGUMENT"
  }
}

常见错误码

HTTP	status	说明
400	INVALID_ARGUMENT	请求参数错误
401	UNAUTHENTICATED	API Key 无效或缺失
403	PERMISSION_DENIED	无权访问该模型或功能（含 GCS 私有桶访问拒绝等）
404	NOT_FOUND	模型不存在或已退役
429	RESOURCE_EXHAUSTED	超出速率限制 / 配额耗尽
500	INTERNAL	服务器内部错误 / 模型服务调用异常
503	UNAVAILABLE	服务暂时不可用

根路径	`https://hub.ai-leapx.com/`
完整路径	`https://hub.ai-leapx.com/v1/chat/completions`

LeapX Hub API 接入文档

📖概述

核心能力

典型场景

🚀快速开始

三步开始调用

接入信息

第一次调用

🔀调用协议怎么选

🧭端点速览

文本生成

图片生成

音频与视频

平台

💬Chat Completions

入参参数

示例代码（多模态 + 流式）

返回参数

choices 字段

返回示例

🧩Responses

普通对话

图片分析

流式响应

函数调用

MCP 调用

📨Messages

鉴权方法

普通对话

图片分析

流式响应

函数调用

请求体参数

内容块类型

响应体参数

✨Gemini 原生

请求体（Request Body）

Content / Part 对象

GenerationConfig 对象

SafetySetting 对象

Tool / ToolConfig

基础文本对话

带系统指令和生成配置

多模态（图片理解）

函数调用

响应体（Response Body）

流式生成（streamGenerateContent）

🖼️图片生成 · OpenAI 兼容

图片生成 — 请求参数

示例代码

返回参数

图片编辑（edits）

方式一：JSON 请求

方式二：multipart/form-data

额外参数透传

🎨图片生成 · Gemini 原生

文生图

参考图生图

🔊语音合成（TTS）

应用场景

入参参数

示例代码

返回示例

🎬视频生成：Seedance / MiniMax H3

已提供的视频模型

能力与输入方式

创建任务参数

生成流程

文生视频：Seedance 2.0 范例

Seedance 2.5 示例

MiniMax H3 示例

首帧图生视频

状态与错误处理

📦模型列表

请求示例

响应示例

返回参数

🔑AccessKey 管理

实践建议

创建入口