对话补全指南

了解如何通过兼容 OpenAI 的消息格式调用 LEAPERone 对话补全，并使用模型选择、流式输出和用量统计。

对话补全端点完全兼容 OpenAI。将现有 OpenAI SDK 或 HTTP 客户端指向 LEAPERone，即可直接使用。

基础请求

POST /v1/chat/completions

curl -X POST https://api.leaper.one/v1/chat/completions \
  -H "Authorization: Bearer sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "auto",
    "messages": [
      {"role": "user", "content": "Explain quantum computing in one paragraph."}
    ]
  }'

响应

{
  "id": "chatcmpl-abc123",
  "object": "chat.completion",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "Quantum computing uses qubits..."
      },
      "finish_reason": "stop"
    }
  ]
}

将 model 设置为 "auto" 后，系统会自动把请求路由到当前最合适的模型。你也可以明确指定模型，例如 "gpt-5-nano"。

流式输出

设置 stream: true 后，结果会通过服务器发送事件（SSE）返回。Token 会在生成过程中逐步发送。

流式请求

curl -X POST https://api.leaper.one/v1/chat/completions \
  -H "Authorization: Bearer sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "auto",
    "stream": true,
    "messages": [
      {"role": "user", "content": "Write a haiku about APIs."}
    ]
  }'

每个 SSE 事件都包含一行 data:，后面是一个 JSON 数据块：

data: {"id":"chatcmpl-abc123","choices":[{"delta":{"content":"Endpoints"},"index":0}]}

data: {"id":"chatcmpl-abc123","choices":[{"delta":{"content":" await"},"index":0}]}

data: [DONE]

工具调用 / 函数调用

你可以传入 tools 数组，让模型调用你定义的函数。模型判断需要调用函数时，会返回 tool_calls。其格式与 OpenAI 函数调用 API 相同。

tools 参数（节选）

{
  "model": "auto",
  "messages": [{"role": "user", "content": "What's the weather in Tokyo?"}],
  "tools": [
    {
      "type": "function",
      "function": {
        "name": "get_weather",
        "description": "Get current weather for a city",
        "parameters": {
          "type": "object",
          "properties": {
            "city": {"type": "string"}
          },
          "required": ["city"]
        }
      }
    }
  ]
}

完整参数列表和响应结构请参阅 API 参考。

OpenRouter 模型

除了内置模型，你还可以通过 OpenRouter 使用来自主要提供商（Anthropic、Google、Meta、Mistral 等）的 350 多个模型。请使用 openrouter/ 前缀，后接 OpenRouter 模型 ID：

使用 OpenRouter 模型

curl -X POST https://api.leaper.one/v1/chat/completions \
  -H "Authorization: Bearer sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "openrouter/anthropic/claude-sonnet-4.6",
    "messages": [
      {"role": "user", "content": "Hello!"}
    ]
  }'

OpenRouter 模型采用上游价格透传，费用与 OpenRouter 上游提供商的价格相同。完整模型列表和价格请参阅 OpenRouter 模型。

示例

模型	`model` 值
Claude Sonnet 4.6	`openrouter/anthropic/claude-sonnet-4.6`
Gemini 2.5 Flash	`openrouter/google/gemini-2.5-flash-preview`
Llama 3.3 70B	`openrouter/meta-llama/llama-3.3-70b-instruct`
DeepSeek V3	`openrouter/deepseek/deepseek-chat`

基础请求

流式输出

工具调用 / 函数调用

OpenRouter 模型

示例

目录