前置要求
在开始之前,请确保您已准备好以下内容:
- 注册账号: 访问 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 作为后端 |