API文档中心
完整的API接口文档，助力快速接入涵光云方言AI服务
快速开始
第一步：获取API密钥
- 注册并登录涵光云方言AI开放平台
- 进入用户中心 → API密钥管理
- 点击「创建API密钥」按钮
- 复制生成的密钥（格式：dialect_xxxxxxxxxxxxxxxx）
第二步：发起API请求
使用您的API密钥，通过HTTP请求调用接口。所有接口都支持POST方法，返回JSON格式数据。
第三步：处理响应
根据返回的JSON数据中的success字段判断请求是否成功，并获取相应的结果数据。
认证说明
所有API请求都需要在HTTP Header中包含API密钥进行身份验证。
X-API-Key: dialect_xxxxxxxxxxxxxxxx Content-Type: application/json
智能对话
方言理解与智能回复对话接口
POST /api/llm.php智能对话接口，支持方言理解和智能回复。基于大模型技术，能够理解各种方言表达方式并给出准确的回应。
请求参数
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| message | string | 是 | 用户消息内容，支持方言表达 |
| dialect | string | 否 | 方言类型：甘肃/青海/陕西/宁夏/新疆/其他 |
| model_id | int | 否 | 指定模型ID，不填则自动选择最优模型 |
| auto_select | bool | 否 | 是否自动选择最优模型，默认true |
| context | array | 否 | 对话上下文，用于多轮对话 |
curl -X POST http://localhost/php方言官网/api/llm.php \
-H "X-API-Key: dialect_xxxxxxxxxxxxxxxx" \
-H "Content-Type: application/json" \
-d '{
"message": "咋办呢这个事情",
"dialect": "甘肃",
"auto_select": true
}'
{
"success": true,
"reply": "这个事情可以这样处理...",
"dialect_detected": "甘肃",
"model": "deepseek-v3",
"tokens_used": 128,
"latency_ms": 520
}
在线测试
方言翻译
方言转普通话翻译翻译接口
POST /api/llm.php方言文本翻译接口，将各种方言表达转换为标准普通话，同时保持原意和表达习惯。
请求参数
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| text | string | 是 | 待翻译的方言文本 |
| source_dialect | string | 否 | 源方言类型 |
curl -X POST http://localhost/php方言官网/api/llm.php \
-H "X-API-Key: dialect_xxxxxxxxxxxxxxxx" \
-H "Content-Type: application/json" \
-d '{
"message": "翻译：俺这疙瘩老鼻子人了",
"dialect": "东北"
}'
{
"success": true,
"original": "俺这疙瘩老鼻子人了",
"translated": "我们这里人很多",
"dialect": "东北"
}
方言识别
自动识别方言类型识别接口
POST /api/llm.php自动识别文本中包含的方言类型和方言特征词，返回识别结果和置信度。
请求参数
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| text | string | 是 | 待识别的文本内容 |
curl -X POST http://localhost/php方言官网/api/llm.php \
-H "X-API-Key: dialect_xxxxxxxxxxxxxxxx" \
-H "Content-Type: application/json" \
-d '{
"message": "识别方言：阿们青海人可精干兰",
"task": "detect"
}'
{
"success": true,
"dialect": "青海",
"confidence": 0.92,
"keywords": ["阿们", "精干", "兰"],
"suggestions": ["青海话特征明显"]
}
大模型调用
直接调用各类大模型API通用大模型接口
POST /api/llm.php支持调用多个主流大模型，包括DeepSeek、智谱GLM、通义千问、零一万物等。支持自动选择最优模型和指定模型调用。
支持的模型
| 模型ID | 模型名称 | 说明 |
|---|---|---|
| 1 | DeepSeek V3 | 深度求索大模型 |
| 2 | Qwen 通义千问 | 阿里云大模型 |
| 3 | GLM-4 智谱AI | 智谱华章大模型 |
| 4 | Yi 零一万物 | 零一万物大模型 |
请求参数
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| model_id | int | 否 | 指定模型ID |
| message | string | 是 | 对话消息 |
| temperature | float | 否 | 采样温度，0-2之间，默认0.7 |
| max_tokens | int | 否 | 最大生成token数 |
import requests
import json
api_key = "dialect_xxxxxxxxxxxxxxxx"
url = "http://localhost/php方言官网/api/llm.php"
payload = {
"message": "你好，请介绍一下甘肃",
"model_id": 1,
"temperature": 0.7
}
headers = {
"X-API-Key": api_key,
"Content-Type": "application/json"
}
response = requests.post(url, headers=headers, json=payload)
result = response.json()
print(f"成功: {result['success']}")
print(f"回复: {result['reply']}")
print(f"模型: {result.get('model', 'N/A')}")
const apiKey = 'dialect_xxxxxxxxxxxxxxxx';
const url = 'http://localhost/php方言官网/api/llm.php';
const response = await fetch(url, {
method: 'POST',
headers: {
'X-API-Key': apiKey,
'Content-Type': 'application/json'
},
body: JSON.stringify({
message: '你好，请介绍一下甘肃',
model_id: 1
})
});
const result = await response.json();
console.log('成功:', result.success);
console.log('回复:', result.reply);
错误码说明
API返回的错误信息包含错误码和详细描述，请根据错误码进行相应的处理。
{
"success": false,
"error": {
"code": 401,
"message": "API密钥无效"
}
}
SDK下载
我们提供多种编程语言的SDK，方便您快速集成API服务。
Python SDK
pip install dialect-sdk
JavaScript SDK
npm install dialect-sdk
Java SDK
maven/gradle 引入
Go SDK
go get dialect-sdk