跳转到主要内容
POST
/
v1
/
chat
/
completions
创建对话请求(openai)
curl --request POST \
  --url https://api.leapx-hub.com/v1/chat/completions \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "<string>",
  "messages": [
    {}
  ],
  "temperature": 123,
  "stream": true,
  "max_tokens": 123,
  "top_p": 123
}
'
{
  "id": "chatcmpl-xxx",
  "object": "chat.completion",
  "created": 1234567890,
  "model": "glm-5",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "人工智能是研究、开发用于模拟、延伸和扩展人的智能的理论、方法、技术及应用系统的一门新的技术科学..."
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 25,
    "completion_tokens": 100,
    "total_tokens": 125
  }
}

​
简介

通用文本对话接口，支持 OpenAI 兼容的大语言模型生成对话回答。通过统一的 API 接口，您可以调用 OpenAI、Claude、DeepSeek、Grok、通义千问等多个主流大模型。

​
认证

​
Authorization
string
必填
Bearer Token，如 Bearer sk-xxxxxxxxxx

​
请求参数

​
model
string
必填
模型标识，支持的模型包括：
  • OpenAI 系列：o4-mini、o3-mini、gpt-5.2、gpt-5.1、gpt-4o、gpt-4o-mini 等
  • Claude 系列：claude-opus-4-6、claude-sonnet-4-5-20250929、claude-haiku-4-5-20251001 等
  • DeepSeek 系列：deepseek-v3-1-250821、deepseek-v3、deepseek-r1 等
  • Grok 系列：grok-4、grok-4-fast-reasoning、grok-3 等
  • Gemini 系列：gemini-3-pro-preview、gemini-3-flash-preview、nano-banana-pro 及其 -thinking/-nothinking / -thinking-<预算> / -thinking-low/-thinking-high 后缀变体
  • 国产模型系列：glm-5、glm-4.7、doubao-seed-1-8-251228（豆包 Seed 系列）、qwen3-coder-plus、kimi-k2.5 等
​
messages
array
必填
对话消息列表，每个元素包含 role（user/system/assistant）和 content
​
temperature
number
默认值:"0.7"
随机性控制，0-2，值越高回复越随机
​
stream
boolean
默认值:"false"
是否启用流式输出，返回 SSE 格式的分片数据
​
max_tokens
number
最大生成 token 数，控制回复长度
​
top_p
number
核采样参数，0-1，控制生成的多样性

​
基础示例

非流式请求
curl -X POST "https://api.leapx-hub.com/v1/chat/completions" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-xxxxxxxxxx" \
  -d '{
    "model": "glm-5",
    "messages": [
      {"role": "system", "content": "你是一个有用的助手"},
      {"role": "user", "content": "请用中文简要介绍人工智能"}
    ],
    "temperature": 0.7
  }'
流式请求（SSE）
curl -N -X POST "https://api.leapx-hub.com/v1/chat/completions" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-xxxxxxxxxx" \
  -d '{
    "model": "doubao-seed-1-8-251228",
    "stream": true,
    "messages": [
      {"role": "system", "content": "你是一个有用的助手"},
      {"role": "user", "content": "请用中文简要介绍人工智能"}
    ]
  }'
Python 示例
from openai import OpenAI

client = OpenAI(
    api_key="sk-xxxxxxxxxx",
    base_url="https://api.leapx-hub.com/v1"
)

# 非流式
completion = client.chat.completions.create(
    model="glm-5",
    messages=[
        {"role": "system", "content": "你是一个有用的助手"},
        {"role": "user", "content": "请用中文简要介绍人工智能"}
    ],
    temperature=0.7
)
print(completion.choices[0].message.content)

# 流式
stream = client.chat.completions.create(
    model="doubao-seed-1-8-251228",
    messages=[
        {"role": "user", "content": "请用中文简要介绍人工智能"}
    ],
    stream=True
)
for chunk in stream:
    if chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="")

{
  "id": "chatcmpl-xxx",
  "object": "chat.completion",
  "created": 1234567890,
  "model": "glm-5",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "人工智能是研究、开发用于模拟、延伸和扩展人的智能的理论、方法、技术及应用系统的一门新的技术科学..."
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 25,
    "completion_tokens": 100,
    "total_tokens": 125
  }
}

​
高级功能

​
工具调用（Functions / Tools）

支持 OpenAI 兼容的工具调用格式，适用于 GPT、Claude、DeepSeek、Grok、通义千问等模型。 
curl -X POST "https://api.leapx-hub.com/v1/chat/completions" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-xxxxxxxxxx" \
  -d '{
    "model": "glm-5",
    "messages": [
      {"role": "user", "content": "上海的天气怎么样？"}
    ],
    "tools": [
      {
        "type": "function",
        "function": {
          "name": "get_weather",
          "description": "根据城市获取天气信息",
          "parameters": {
            "type": "object",
            "properties": {
              "city": {"type": "string"}
            },
            "required": ["city"]
          }
        }
      }
    ],
    "tool_choice": "auto"
  }'

​
结构化输出（JSON Schema）

支持通过 response_format 参数控制输出格式，适用于 GPT、Claude、Grok 等模型。 
curl -X POST "https://api.leapx-hub.com/v1/chat/completions" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-xxxxxxxxxx" \
  -d '{
    "model": "doubao-seed-1-8-251228",
    "response_format": {
      "type": "json_schema",
      "json_schema": {
        "name": "Answer",
        "schema": {
          "type": "object",
          "properties": {
            "summary": {"type": "string"}
          },
          "required": ["summary"]
        }
      }
    },
    "messages": [
      {"role": "user", "content": "返回一个包含 summary 字段的 JSON"}
    ]
  }'
严格的结构化输出建议降低 temperature 值（如 0.1-0.3），并设置合适的 max_tokens 以提升一致性。

​
思考能力

部分模型支持思考能力（Thinking/Reasoning），可以在生成回复时展示推理过程。不同模型的实现方式不同：
DeepSeek 模型支持通过 thinking 字段开启思考能力：
curl -X POST "https://api.leapx-hub.com/v1/chat/completions" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-xxxxxxxxxx" \
  -d '{
    "model": "deepseek-v3-1-250821",
    "messages": [
      {"role": "system", "content": "你是一个有用的助手"},
      {"role": "user", "content": "给出一道中等难度的几何题并分步解析"}
    ],
    "thinking": {"type": "enabled"}
  }'
  • 默认 thinking.type 为 "disabled"，需要显式设置为 "enabled" 开启
  • 思考能力的输出形态可能因模型版本而异
  • 建议配合 stream: true 以获得更好的交互体验

​
通义千问扩展功能

通义千问模型支持搜索、语音识别等扩展功能，所有扩展参数需放入 parameters 对象中。 
curl -X POST "https://api.leapx-hub.com/v1/chat/completions" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-xxxxxxxxxx" \
  -d '{
    "model": "qwen3-omni-flash",
    "messages": [
      {"role": "user", "content": "请先检索近期关于费马大定理的常见误解，再回答"}
    ],
    "stream": true,
    "enable_thinking": true,
    "parameters": {
      "enable_search": true,
      "search_options": {
        "region": "CN",
        "recency_days": 30
      },
      "incremental_output": true
    }
  }'
通义千问的所有扩展参数（如 enable_search、search_options、asr_options、temperature、top_p 等）都需要放在 parameters 对象中，而不是请求体的顶层。

​
联网搜索功能

部分模型支持实时联网搜索，可以获取最新信息并在响应中包含引用来源。
Claude 模型不支持通过 web_search_options 参数开启网络搜索功能，所以使用只能通过tool工具调用实现，且可能因为网络和提示词等原因不稳定,详细看上面工具调用（Functions / Tools）。基础示例（展示工具调用流程）：
curl -X POST "https://api.leapx-hub.com/v1/chat/completions" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-xxxxxxxxxx" \
  -d '{
    "model": "glm-5",
    "messages": [
      {"role": "user", "content": "最近关于人工智能的新闻有哪些？"},
      {
        "role": "assistant",
        "content": "我来帮你搜索一下最近关于人工智能的新闻。",
        "tool_calls": [
          {
            "id": "toolu_xxx",
            "type": "function",
            "function": {
              "name": "WebSearch",
              "arguments": "{\"query\": \"人工智能 最新新闻 2025\"}"
            }
          }
        ]
      },
      {
        "role": "tool",
        "tool_call_id": "toolu_xxx",
        "name": "WebSearch",
        "content": "Web search results for query: \"人工智能 最新新闻 2025\"..."
      }
    ],
    "web_search_options": {
      "search_context_size": "medium"
    }
  }'
带位置信息的示例（展示工具调用流程）：
curl -X POST "https://api.leapx-hub.com/v1/chat/completions" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-xxxxxxxxxx" \
  -d '{
    "model": "glm-5",
    "messages": [
      {"role": "user", "content": "上海今天的天气怎么样？"},
      {
        "role": "assistant",
        "content": "我来帮你搜索一下上海今天的天气情况。",
        "tool_calls": [
          {
            "id": "toolu_xxx",
            "type": "function",
            "function": {
              "name": "WebSearch",
              "arguments": "{\"query\": \"上海今天天气\"}"
            }
          }
        ]
      },
      {
        "role": "tool",
        "tool_call_id": "toolu_xxx",
        "name": "WebSearch",
        "content": "Web search results for query: \"上海今天天气\"..."
      }
    ],
    "web_search_options": {
      "search_context_size": "medium",
      "user_location": {
        "approximate": {
          "timezone": "Asia/Shanghai",
          "country": "CN",
          "region": "Shanghai",
          "city": "Shanghai"
        }
      }
    }
  }'
  • 搜索功能会增加响应时间和 token 消耗（包含搜索结果内容）
  • 搜索结果会在响应中自动包含引用来源
  • 支持的模型包括 Claude Sonnet 4、Claude 3 Opus 等
  • 在多轮对话中，工具调用和结果会在消息历史中可见，模型可以基于之前的搜索结果继续对话
稳定性说明：
  • 联网搜索功能依赖上游代理服务和外部搜索服务，可能存在以下不稳定性：
    • 网络波动：网络连接问题可能导致搜索请求超时或失败
    • 服务限制：搜索服务可能有频率限制、超时限制或临时不可用
    • 搜索结果质量：某些查询可能无法找到相关信息，或搜索结果质量不佳
    • 模型判断：模型会根据问题自动判断是否需要搜索，某些情况下可能不会触发搜索

​
GPT 文件输入（Responses API）

GPT-5 等模型支持文件输入功能，需要通过 /v1/responses 接口调用，而不是 /v1/chat/completions。
您可以通过链接外部网址上传 PDF 文件：
from openai import OpenAI

client = OpenAI(
    api_key="sk-xxxxxxxxxx",
    base_url="https://api.leapx-hub.com/v1/responses?api-version=2025-03-01-preview"
)

response = client.responses.create(
    model="gpt-5.2",
    input=[
        {
            "role": "user",
            "content": [
                {
                    "type": "input_text",
                    "text": "分析这封信，并总结其关键点"
                },
                {
                    "type": "input_file",
                    "file_url": "https://www.example.com/document.pdf"
                }
            ]
        }
    ]
)
print(response.output_text)
  • 文件大小限制：单个文件不超过 50 MB，单个请求中所有文件总大小不超过 50 MB
  • 支持的模型：gpt-4o、gpt-4o-mini、gpt-5-chat 等支持文本和图像输入的模型
  • 推理模型（o1、o3-mini、o4-mini）如需使用推理能力，也应使用 /v1/responses 接口

​
Grok 推理能力

Grok 模型（特别是 grok-4-fast-reasoning）支持推理能力，响应中的 usage 会区分 completion_tokens 和 reasoning_tokens： 
{
  "usage": {
    "prompt_tokens": 100,
    "completion_tokens": 500,
    "total_tokens": 600,
    "completion_tokens_details": {
      "reasoning_tokens": 300
    }
  }
}
实际输出文本的 token 数 = completion_tokens - reasoning_tokens

​
响应格式

{
  "id": "chatcmpl-xxx",
  "object": "chat.completion",
  "created": 1234567890,
  "model": "glm-5",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "回复内容..."
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 25,
    "completion_tokens": 100,
    "total_tokens": 125
  }
}

​
错误处理

异常类型触发场景返回信息
AuthenticationErrorAPI密钥无效或未授权错误：API密钥无效或未授权
NotFoundError模型不存在或不被支持错误：模型 [model] 不存在或不被支持
APIConnectionError网络中断或服务器未响应错误：无法连接到API服务器
APIError请求格式错误等服务端异常API请求失败：[错误详情]

​
支持的模型系列

​
OpenAI 系列

  • GPT-4.1、GPT-4o、GPT-4o Mini、GPT-3.5-turbo
  • 推理模型：o3-mini、o4-mini（需使用 /v1/responses 接口）

​
Claude 系列（Anthropic）

  • Claude Sonnet 4、Claude 3 Opus、Claude 3 Haiku

​
DeepSeek 系列

  • DeepSeek V3、DeepSeek R1

​
Grok 系列（xAI）

  • Grok-4、Grok-3、Grok-3-fast、Grok-4-fast-reasoning

​
通义千问系列（Qwen）

  • Qwen3-omni-flash 等

​
豆包 Seed 系列（Doubao）

  • doubao-seed-1-8-251228 等

​
其他模型

  • Gemini 系列、GLM 系列（含 glm-5）、Kimi 系列等
完整模型列表请查看 模型信息页面。

​
注意事项

  • messages 列表中 system 角色用于设定模型行为，user 角色为用户提问
  • 多轮对话需追加历史记录（包含 assistant 角色的回复）
  • 依赖 openai 库：pip install openai
  • 不同模型对某些功能的支持程度可能不同，建议在使用前查看具体模型的文档
  • 使用流式输出可以提升首字响应时间和交互体验
  • 工具调用需要做好超时与重试机制，避免阻塞模型响应
  • 通义千问的扩展参数必须放在 parameters 对象中

​
相关资源

常见问题

查看对话接口的常见问题解答

模型列表

查看所有支持的模型信息