大模型 API 接入指南

本文说明如何把 lxai 的文本、多模态、工具调用和流式输出接入到你的应用。

1. 选择端点

新项目优先使用 OpenAI Responses API。它是 OpenAI 当前统一的文本、图片、文件和工具调用接口。

POST https://www.lxai.pro/v1/responses

如果你的 SDK、框架或第三方工具只支持 Chat Completions，继续使用 OpenAI Chat Completions 兼容协议。

POST https://www.lxai.pro/v1/chat/completions

如果你的代码已经按 Anthropic Messages API 开发，使用 Anthropic Messages 官方协议。

POST https://www.lxai.pro/v1/messages

所有协议都使用同一个 API Key。OpenAI 风格请求使用：

Authorization: Bearer YOUR_API_KEY

Anthropic 风格请求可以使用：

x-api-key: YOUR_API_KEY
anthropic-version: 2023-06-01

API Key 可在 令牌管理页面 创建。不要把真实 Key 写进前端代码、截图、日志或代码仓库。

2. 查询模型

模型会持续更新，请以模型列表接口返回为准。

curl "https://www.lxai.pro/v1/models" \
  -H "Authorization: Bearer YOUR_API_KEY"

常见模型族：

• OpenAI / OpenAI 兼容模型：gpt-*、o*
• Claude 模型：claude-*
• Gemini 模型：gemini-*
• 其他兼容模型：以模型列表接口返回为准

不是所有模型都支持图片、工具调用、推理参数或 Responses API。集成前先用目标模型做一次最小请求测试。

3. OpenAI Responses API

适合新项目。请求体使用 input 字段。

文本请求：

curl -X POST "https://www.lxai.pro/v1/responses" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.2",
    "input": "用三句话介绍 lxai"
  }'

图片输入请求：

curl -X POST "https://www.lxai.pro/v1/responses" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.2",
    "input": [
      {
        "role": "user",
        "content": [
          {"type": "input_text", "text": "描述这张图片，并提取图片里的文字"},
          {"type": "input_image", "image_url": "https://example.com/image.png"}
        ]
      }
    ]
  }'

Base64 图片也可以用 Data URL：

{
  "type": "input_image",
  "image_url": "data:image/png;base64,BASE64_IMAGE_DATA"
}

流式输出：

curl -N -X POST "https://www.lxai.pro/v1/responses" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.2",
    "input": "写一个 5 行的产品介绍",
    "stream": true
  }'

常用字段：

• model：必填，模型名称。
• input：必填，字符串或结构化输入。
• instructions：系统级指令。
• stream：是否流式输出。
• max_output_tokens：最大输出 token。
• reasoning.effort：推理强度，支持范围以具体模型为准。
• tools：工具定义。需要内置工具时优先使用 Responses API。
• previous_response_id：继续上一轮响应，适合有状态工作流。

4. OpenAI Chat Completions 兼容协议

适合已有 OpenAI Chat Completions 代码、老 SDK、第三方工具或只支持 /v1/chat/completions 的客户端。

文本请求：

curl -X POST "https://www.lxai.pro/v1/chat/completions" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-4o",
    "messages": [
      {"role": "user", "content": "你好，介绍一下你自己"}
    ]
  }'

图片输入请求：

curl -X POST "https://www.lxai.pro/v1/chat/completions" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-4o",
    "messages": [
      {
        "role": "user",
        "content": [
          {"type": "text", "text": "描述这张图片"},
          {
            "type": "image_url",
            "image_url": {
              "url": "https://example.com/image.png",
              "detail": "high"
            }
          }
        ]
      }
    ]
  }'

Base64 图片：

{
  "type": "image_url",
  "image_url": {
    "url": "data:image/jpeg;base64,BASE64_IMAGE_DATA",
    "detail": "high"
  }
}

工具调用请求：

{
  "model": "gpt-4o",
  "messages": [{"role": "user", "content": "北京天气如何？"}],
  "tools": [
    {
      "type": "function",
      "function": {
        "name": "get_weather",
        "description": "获取天气信息",
        "parameters": {
          "type": "object",
          "properties": {
            "location": {"type": "string", "description": "城市名"}
          },
          "required": ["location"]
        }
      }
    }
  ]
}

常用字段：

• model：必填，模型名称。
• messages：必填，对话消息数组。
• stream：是否流式输出。
• max_completion_tokens：最大输出 token。新模型优先使用它。
• temperature / top_p：采样参数。推理模型可能不支持。
• tools / tool_choice：工具定义和工具选择。
• response_format：结构化输出。
• reasoning_effort：部分推理模型支持。

5. Anthropic Messages 官方协议

适合已有 Claude / Anthropic SDK 代码。

文本请求：

curl -X POST "https://www.lxai.pro/v1/messages" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-4-20250514",
    "max_tokens": 1024,
    "messages": [
      {"role": "user", "content": "你好，介绍一下你自己"}
    ]
  }'

图片输入请求：

curl -X POST "https://www.lxai.pro/v1/messages" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-4-20250514",
    "max_tokens": 1024,
    "messages": [
      {
        "role": "user",
        "content": [
          {"type": "text", "text": "描述这张图片"},
          {
            "type": "image",
            "source": {
              "type": "url",
              "url": "https://example.com/image.png"
            }
          }
        ]
      }
    ]
  }'

Base64 图片：

{
  "type": "image",
  "source": {
    "type": "base64",
    "media_type": "image/png",
    "data": "BASE64_IMAGE_DATA"
  }
}

常用字段：

• model：必填，Claude 模型名称。
• messages：必填，对话消息数组。
• max_tokens：必填，最大输出 token。
• system：系统提示词。
• stream：是否流式输出。
• tools：工具定义。
• thinking：扩展思考配置（部分模型支持）。

6. SDK 集成

Python (OpenAI SDK)

from openai import OpenAI

client = OpenAI(
    api_key="YOUR_API_KEY",
    base_url="https://www.lxai.pro/v1"
)

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

Python (Anthropic SDK)

import anthropic

client = anthropic.Anthropic(
    api_key="YOUR_API_KEY",
    base_url="https://www.lxai.pro"
)

message = client.messages.create(
    model="claude-4-5-sonnet-20250929",
    max_tokens=1024,
    messages=[{"role": "user", "content": "你好"}]
)
print(message.content[0].text)

Node.js (OpenAI SDK)

import OpenAI from 'openai';

const client = new OpenAI({
  apiKey: 'YOUR_API_KEY',
  baseURL: 'https://www.lxai.pro/v1',
});

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