快速开始

Ling.AI 统一大模型 API 网关,3 分钟即可接入 OpenAI、Anthropic、Google 等 100+ 大模型。完全兼容官方 SDK,无需修改代码。

前置要求

在开始之前,请确保您已准备好以下内容:

  • 注册账号: 访问 Ling.AI 控制台 注册账号
  • 获取 API Key: 在控制台 > API Key 中创建并复制您的 API Key
  • 开发环境: Python 3.8+ 或 Node.js 18+ 或其他支持 HTTP 请求的语言
  • 基本了解: 了解 REST API 和 JSON 格式

💡 Ling.AI 兼容三大协议

完全兼容 OpenAI / Anthropic / Google 三大 API 协议,您可以使用任意官方 SDK 进行接入,只需修改 base URL 即可。

选择接入方式

Ling.AI 支持三种主要的接入方式,您可以根据自己的技术栈选择:

OpenAI SDK 推荐

OpenAI 兼容协议,最通用的接入方式,适合大多数用户。

curl
# 使用 OpenAI 兼容协议
curl https://api.lingyuncx.com/v1/chat/completions \
  -H "Authorization: Bearer <你的 API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "qwen-plus",
    "messages": [{"role": "user", "content": "Hello, how are you?"}]
  }'
Python
from openai import OpenAI

client = OpenAI(
    base_url="https://api.lingyuncx.com/v1",
    api_key="<你的 API_KEY>"
)

response = client.chat.completions.create(
    model="qwen-plus",
    messages=[
        {"role": "system", "content": "You are a helpful assistant."},
        {"role": "user", "content": "Hello, how are you?"}
    ]
)

print(response.choices[0].message.content)
TypeScript
import OpenAI from 'openai';

const client = new OpenAI({
  baseURL: 'https://api.lingyuncx.com/v1',
  apiKey: '<你的 API_KEY>'
});

const response = await client.chat.completions.create({
  model: 'qwen-plus',
  messages: [
    { role: 'system', content: 'You are a helpful assistant.' },
    { role: 'user', content: 'Hello, how are you?' }
  ]
});

console.log(response.choices[0].message.content);

Anthropic SDK Anthropic 原生

Anthropic 原生协议,直接使用 Anthropic SDK,完整支持 Claude 全部功能。

curl
# 使用 Anthropic 原生协议
curl https://api.lingyuncx.com/anthropic/v1/messages \
  -H "x-api-key: <你的 API_KEY>" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-3-sonnet",
    "max_tokens": 1024,
    "messages": [{"role": "user", "content": "Hello!"}]
  }'
Python
import anthropic

# 创建客户端(使用 Ling.AI API Key)
client = anthropic.Anthropic(
    base_url="https://api.lingyuncx.com/anthropic",
    api_key="<你的 API_KEY>"
)

# 创建消息
message = client.messages.create(
    model="claude-3-sonnet",
    max_tokens=1024,
    messages=[
        {"role": "user", "content": "Hello, how can I help you today?"}
    ]
)

print(message.content[0].text)

Gemini SDK Google 原生

Gemini 原生协议,使用 Google GenAI SDK,支持 Gemini 全系模型。

curl
# 使用 Gemini 原生协议
curl "https://api.lingyuncx.com/gemini/v1beta/models/google/gemini-3-flash-preview:generateContent" \
  -H "x-goog-api-key: <你的 API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "contents": [{"parts": [{"text": "Hello!"}]}]
  }'
Python
from google import genai

client = genai.Client(
    api_key="<你的 API_KEY>",
    http_options={"base_url": "https://api.lingyuncx.com/gemini"}
)

response = client.models.generate_content(
    model="google/gemini-3-flash-preview",
    contents="Hello, how are you?"
)

print(response.text)

API 端点参考

提供商 Base URL 认证方式 适合场景
OpenAI https://api.lingyuncx.com/v1 Authorization: Bearer <KEY> 通用SDK、最常用
Anthropic https://api.lingyuncx.com/anthropic x-api-key: <KEY> Claude模型、完整功能
Gemini https://api.lingyuncx.com/gemini x-goog-api-key: <KEY> Gemini模型、原生体验

下一步

完成基本接入后,您可以:

  • Keys 在控制台管理您的 API Key 和访问权限
  • Models 查看可用的 100+ 大模型列表
  • Streaming 了解如何接入流式响应 (SSE)
  • Function Calling 使用函数调用功能集成外部工具
  • Provider Routing 配置智能路由实现负载均衡

⚠️ 安全提示

请勿将 API Key 硬编码在代码中,建议使用环境变量管理:

export XIAOW_API_KEY="sk-xxxxxxxx"

工具集成

Ling.AI 支持与以下工具完美集成:

工具 类型 集成方式
Claude Code AI 编程助手 配置 API Key 即可使用
Zed Editor 代码编辑器 内置 Ling.AI 支持
Cline VS Code AI 助手 使用 OpenAI 兼容协议
Cherry Studio 跨平台客户端 配置 Ling.AI 作为后端